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Foreword 



GEOS (Graphic Environment Operating System) has changed the face of 
home computing. Until now, home computer users were pretty much on 
their own once they bought the computer, and either had to shell out the 
money for ready-to-run programs, or go through tiie tedious process of 
learning a computer language and do their own programming. But GEOS 
comes with the 64G when you buy it — ^you're ready to run it the moment 
you get home. 

Since we follow Commodore closely, we were wondering just what 
difference there was between the "new" 64C and the old C-64. When we 
saw GEOS, we were overjoyed. The 64 now has an advanced user interface 
similar to GEM, an interface previously available only in much higher- 
priced computers. Most commands don't need to be typed in. Instead, 
graphic symbols are used. Now when you want to delete a file, you no 
longer need to type: 

OPEN 1,8,15, "SO :NAME":CL0SE1 

Now you just move an icon, or symbol that represents the program, and 
"deposit" it in to another icon that looks like a waste basket. It's hard to 
believe what the developers of GEOS have done with the 64. WeVe spent 
many hours in front of our 64*s learning about the the new GEOS system, 
and we're constantiy amazed by its capabilities. GEOS is the user-fnendly 
interface that beginners have been waiting for. 

A few points about our book: 

1. If you have bought this book because you are still hesitant about 
buying a computer and want some information about the 64C and 
GEOS, to a great extent we wrote this book for you. There is a 
thorough introduction to working with GEOS, with scores of 
actual screen illustrations, to help you make your decisions about 
your computer purchase. 

2. If you are among those who akeady have a 64C (or an older 
C-64) and GEOS, you will also find tiie introduction to GEOS 
valuable. Well be pointing out all the things that GEOS can do. 
Give your creativity free rein; we'll try to spark your imagination 
with the suggestions and hints we have to offer. GEOS will 
allow the artist in you to run wild. Keep this book handy 
whenever you work with geoWrite and geoPaint. 
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Do you have a favorite BASIC program in '64 format— or even a 
machine language program — ^that you would like to run under 
GEOS? Do you want to create your own custom icons for your 
programs running under GEOS? Or do you want to add your 
name to the info box to identify yourself as the author of a 
program? If you answered yes to any of these questions, then 
Chapter 5 should be of special interest to you. It contains the 
pertinent information and the FILEMASTER program, which 
enables you to do all of these things and more. 

3. Some of you may be progranmiers who would like to combine 
your own program routines with GEOS. This book should 
clarify the steps you need to know. We have saved you the 
trouble of doing the "grunt work" of finding GEOS file structure, 
joystick control, etc. Apply your energies to the programming, 
and use the information and assistance contained in this book as 
reference. 

We think that it's well worth the effort to write programs for and 
under GEOS, and we want this book to support later adaptations 
of the GEOS concept. However, since GEOS is a completely 
new operatimg system, some memory locations specified in this 
book may differ by a few bytes from those of your system. 

We wish to thank Conmiodore for its friendly support. In particular, we 
would like to thank Dr. Kittel, who helped us along throughout the project. 

Manfred Tomsdorf 
Riidiger Kerkloh 
Muenster, Germany 
July 30, 1986 
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Using this book 



Versions: GEOS V1.0 and GEOS \12 

At the time of this writing, there are still a few difficulties in using GEOS 
VL2. An earlier release, GEOS Vl.O, may still be on the market 

The FILEMASTER program in Chapter 5 will work with both GEOS VLO 
and GEOS VL2. The other programs work only with GEOS VL2. It's 
unfortunate that the intemal differences between VLO and VI. 2 are so great 
that most of the documentation of many routines and memory locations 
apply only to VL2. 

Here's how to tell VLO from other versions: 

• Page 1 of the directory does not have the BACKUP program. V 1.0 
users can use any copy program. 

• The individual pages of the directory can only be seen by flipping 
those pages. 

• geoPaint will draw only monochrome pictures. 
We hope that you have GEOS V1.2 ! 



Presentation 

Don't be surprised when you run into similar formats and formulas 
throughout this book. We do this to ensure your success with this book. 
GEOS was systematically designed, and we have taken great efforts to 
make our book as systematic and thorough as possible. You'll see that the 
chapters are all arranged in a similar format. YouH notice quite a bit of this 
overlapping in our book regarding individual program sections. We did this 
not so much for creative purposes, but to ensure tiiat the reader understands 
the material completely. 
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Repetition 

There is a second, subtle characteristic you will see as you read this book. 
Information is often repeated from chapter to chapter, even though stating 
the same information once in a single chapter would be sufficient. We did 
this to save you page-turning. We Imow how difficult it is to work with one 
hand trying to find the page, and the other trying to handle the computer. 

We essentially wanted each chapter to be an independent section of the 
book, so you wouldn't have to tum a lot of pages. 



Illustratioiis 

As you thumb through this book, you may be wondering why we included 
so many illustrations, and whether all these screen dumps were necessary 
when you can see for yourself what's on the screen. We decided that this 
book, or at least a good part of it, would be designed for simply reading 
about the capabilities of GEOS. The illustrations also help to user to read 
now, see the results immediately, and try the procedures later on his 
computer. 

Another advantage to all these illustrations is that every time your actual 
screen appears, you can compare it with the illustration, to make sure that 
everything is correct 

Remarlcs 

You will see some differences between most of the illustrations in this book 
and your own screen. This is because hardcopy (a printout of the screen) 
does not display sprites. Different objects in GEOS — for example, the 
pointer, the small rectangle in the page pointer, and current color marker in 
color list — are constructed as sprites, and therefore do not appear on the 
screen. However, don't be concerned about the differences between our 
illustrations and your screens. When the icons are in sprite format and don't 
appear on our illustrations, they will still appear normally on your GEOS 
screens. 
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[GEOS For Beginners) 
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GEOS for beginners 



You may be wondering why we included this chapter at all, considering you 
already have a copy of the GEOS User's Guide. This section is for the 
computer tenderfoot looking into a strange land, viewing this geography 
from a different perspective than the veteran user. The GEOS User's Guide 
may not be appropriate for the first-timer. But tfie corresponding chapters of 
this book were written to make the learning process easier for those 
newcomers with a minimal knowledge of computers. 

If you still have questions about words or phrases, the Glossary at the end 
of this book defines the common terms. 



2.1 Backup copies and work diskettes 



Before you start working with GEOS, you absolutely must make a backup 
copy of your original diskette. It's all too easy to accidentally delete a 
program forever from the original diskette. 

The only reason you should use your original diskette is to load (boot) 
GEOS. Use the backups and work diskettes for your applications. 

To make a backup copy of the original GEOS diskette, perform the 
following steps: 

1 . Turn on your computer and disk drive. Plug the joystick into the 
port closest to you on the righthand side of the '64. Tum off the 
printer, if you have one connected. 

2. Insert the GEOS distribution diskette and type: 

LOAD " GEOS ",8,1 <RETURN> 

After five seconds BOOTING GEOS appears on the screen. 
GEOS is loaded in about 30 seconds, and the different icons 
(symbols) appear on the screen. If all has gone well, proceed to 
step 3 on the next page. 
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If the main window doesn't appear on the monitor, one of two 
things may happen instead: 

• After five seconds, BOOTING GEOS appears on the screen; 
suddenly the screen compresses and retums you to Ihe 64 
power-up screen. This means that GEOS thinks the diskette 
is not copy protected. You must start over and LOAD 
"GEOS", 8, 1 to re-try the operation. If GEOS keeps 
refusing to load, see Chapter 5.1.1 for help. If all else fdls, 
take the GEOS diskette to your Commodore dealer — eitfier 
the GEOS diskette is defective or your disk drive needs 
alignment 

• The status lamp (red for 1541 drives, green for 1571 drives) 
lights and goes out, yet the 64 doesn't react. This means a 
load error has occurred — ^you'll have to start over. If this 
happens repeatedly, take the diskette back to your 
Conmiodore dealer for replacement 

3. When the icons appear on the screen and the disk drive stops, 
look for an arrow in the upper left comer of the screen. This 
arrow, or pointer, is moved with your joystick. Move the pointer 
to the BACKUP icon and press the fire button. The icon will 
change color. Move the pointer to the first line of the window 
(the command menu), to tfie rectangle that reads file. Press the 
fire button on the joystick. A sub-menu drops down with several 
choices called items. The pointer is automatically set on open. 
Press the fire button again. 

4. The disk drive runs, then the following appears on the screen: 
DISK BACKUP /RESTORE UTILITY 

INSERT DESTINATION DISK TO BE FORMATTED AND 
ENTER F TO FORMAT, OR Q TO QUIT (F/Q) 

Remove the original diskette from the disk drive and insert a 
new, blank diskette. (This becomes the "destination diskette"). 

5. Press the F key and then <RETURN>. FORMATTING 
DESTINATION DISK appears on the screen. The diskette is 
formatted in about one and a half minutes. Remove this diskette. 
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When this message appears: 

INSERT SOURCE DISK AND ENTER C TO COPY (C) 

..•insert the original diskette and press C and <RETURN>. The 
screen will read: 

READING SOURCE DISK 
After a few seconds the screen changes to read: 

PLEASE INSERT DESTINATION DISK 

Remove the original diskette and put in your newly formatted 
diskette. When you close the disk drive, this message appears: 

WRITING DESTINATION DISK 

The system asks you to switch the original diskette (SOURCE) 
and the new diskette (DESTINATION) two more times. 

6. The backup procedure won't take long; just remember to close 
the disk drive after every diskette exchange. When the backup 
procedure is completed, ttie following message appears: 

BACKUP COMPLETE! INSERT GEOS BOOT DISK AND 
PRESS RESTORE 

Put the original diskette into the disk drive and press the 
<RESTORE> key at the upper right side of the C-64 keyboard. 

7. While the diskette is loading, put your backup copy in a safe spot. 
This should be used in place of the original only if necessary. 

8. When the icons have appeared on the screen, go back to step 3 
and make another backup. This will be your work diskette. You 
are now finished with the backup copy procedure. 
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You should have three diskettes now: 

• Original diskette 

• Backup copy 

• Work diskette 

After you re-insert the original diskette and press <RESTORE>, the main 
GEOS window reappears. 

Note: Once the GEOS window reappears, remove the original diskette from 
the disk drive and replace it with the work diskette. 
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2.2 Preparing the work diskette 



Now that you have a work diskette, you're ready to start learning GEOS. 

If you haven't yet loaded GEOS, but you have your backup and work 
diskettes made, then load GEOS from the original diskette with: 

LOAD "GEOS", 8, 1<RETURN> 

After GEOS is loaded, remove the original diskette. Use the original 
diskette only for the initial loading process. Use work diskettes for the otiier 
procedures. 

Your screen should look like this: 




Figure 1: The deskTop 



11 



Abacus Software 



GEOS Inside and Out 



Before we begin working with GEOS, there are three things you must do: 

!• GEOS knows when you have changed diskettes. The original 
diskette was used to load GEOS, and you should have replaced 
it with the work diskette. Move the pointer with your joystick to 
the word disk on the command menu. Pressing the fire button 
on this choice opens up a sub-menu of items (just as you used 
open for BACKUP) which you choose by moving the pointer to 
that command and pressing the fire button. 

After you click disk the sub-menu appears on the screen: 




Figure 2: disk sub-menu 



Place the pointer on the close item and press the fire button 
(we'll call this clicking from here on). The icons 
change — ^instead of the diskette icon in the upper right comer, an 
icon with a question mark appears. GEOS is waiting for you to 
open the diskette that you have inserted. 
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Click disk again, and click open from dhe sub-menu. The disk 
drive will run for a few seconds, and the icons of the disk 
directory will appear. This is your work diskette directory. 

2. It is extremely important that the different diskettes you use with 
GEOS have different names from one another. Since the 
BACKUP program produces a complete copy of the original 
diskette including tihie diskette name, you should change the 
name of the work diskette. This is pretty easy to do in GEOS: 

Click the disk menu, then select the item rename. A dialogue 
box appears on the screen with this prompt: 




Figure 3: Rename window 

The <DEL> key deletes the old name. You have up to two lines 
to enter a new name. Enter a new name for this disk. For 
example, we used WORK 1. 
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Press <RETURN> after the new diskette name. The window 
will disappear. Now you can tell the original from the work 
diskette by its name. 

3. The last step before starting GEOS is to make some room on the 
work diskette. A message at the top of the main menu says: 

K bytes free . 

The GEOS diskette is full of programs. In fact, in order for you 
to use GEOS, one or more programs must be deleted from the 
diskette. Since only three programs on the distribution diskette 
are needed to boot GEOS, you can delete these files from your 
backup and work diskette: GEOS, GEOS BOOT and GEOS 
KERNAL. Before deleting these programs, be sure that the write 
protect tab is removed (the write protect tab covering the notch on 
the side of the diskette normally prevents accidental deletion). 

GEOS has info boxes for every program, into which the write 
protect box data is stored. Move Ihe pointer to GEOS KERNAL 
and click it once. The icon changes color. GEOS tells you what 
commands are available in GEOS KERNAL. Choose the file 
menu, and click info. The disk drive will run, and the info 
box appears: 
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Figure 4: info box 

This window contains information about the program. We are interested in 
one line in particular: Write Protect. The small filled box in this line 
signifies active write protection. To deactivate the write protect function, 
click the write protect box. It tums white, and GEOS KERNAL can now be 
deleted. Save this change to diskette and close the window (click the close 
icon on the upper right comer of the window). The window closes, the disk 
drive runs, and GEOS KERNAL is now deletable. 

Note: Before you delete GEOS KERNAL, be sure you have the work 
diskette in Ihe disk drive and not the original diskette. 

Never delete a program from the original diskette. 

GEOS KERNAL should now be a darker color than the other icons. If this is 
not the case, click GEOS KERNAL once. Click GEOS KERNAL 
again.When you move the joystick, an image of GEOS KERNAL moves 
instead of the porater (this is a ghost icon ). Move the inverted image to the 
waste basket in the lower right comer and press the fire button. The disk 
drive mns, and the place GEOS KERNAL occupied is now empty. 
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Repeat the procedure for GEOS and GEOS BOOT, Click the icon, move the 
inverted image to the waste basket and click again. Now you should have 
room on your work diskette for files, and your screen should look like this: 



Noik 1 



143 K bqtes used 



23 K bqtes free 



as 



DESK TOP 



CEOPAINT CEOWRITE 



BACKUP 



Figure 5: deskTop without GEOS, GEOS BOOT or GEOS KERNAL 
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23 The perfect setup: The Preference Manager 

GEOS has several accessory programs in addition to the main application 
programs geoWrite and geoPaint. One such accessory is the Preference 
Manager, with which you can change and store certain parameters to your 
own liking (pointer speed and shape, installation data, etc.)- This accessory 
is loaded every time GEOS is loaded. Changing these parameters will not 
destroy any of your documents, so don't be afraid to experiment with them. 

Lefs load the Preference Manager. All the accessories appear as icons on 
the screen and as filenames under the geos menu. Go to the gees menu 
and click the desired accessory. For example, to open the Preference 
Manager, move the joystick pointer to the upper left comer, click on geos, 
then move the pointer to preference mgr and press the fire button on 
that selection. The disk drive will run for a few seconds, then a new 
window appears: 




Figure 6: Preference Manager 
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The first thing you should do is change the time and date. You should do 
this every time you work with GEOS, since every document file is marked 
witili the date and time. This helps you to immediately determine the last time 
you edited a document file, for example. Move the pointer to TIME SET. 
Move the text cursor to the P with the spacebar. The numbers are not erased 
by the spacebar— only the cursor is moved. GEOS will accept only valid 
terms. You can change the PM to an AM, and that's about all. GEOS will 
ignore any other keys at this particular point. Move the text cursor to the 
first number and change the time. 

For example, press 9 4 5 3 A <RETURN>. The clock now reads 
09:45:30 AM. Change the clock to the current time (hours from to 12 
only). 

Now change the date by setting the pointer to DATE SET and entering the 
date in the format Month/Day/Year. The cursor also can be moved here by 
the spacebar. Remember to press <RETURN> when done editing the date. 

Many other changes can be made with the Preference Manager. See Chapter 
3.6.4 for complete details on the Preference Manager. For now, though, 
you'll only use this accessory to set the current time and date. 

When working with these accessories, you should know that memory 
limitations may prevent programs such as the Preference Manager from 
loading. As long as your work diskette has enough memory, this won't 
happen. However, when there are less than 5K free on a diskette, GEOS 
displays an error message: 

NOT ENOUGH DISK SPACE 

This means that GEOS needs more disk space, otherwise the accessory will 
not be loaded. GEOS stores a section of itself on disk before loading an 
accessory. This is called a SWAP file. If there is not enough memory on the 
diskette, the error message appears. Make absolutely sure that there is 
enough room on the work diskette. 

Now let's return to the deskTop. Move the pointer to the upper right comer 
(EXIT) and press the fire button. The main GEOS window will appear after 
a few seconds. 
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2.4 Work diskettes: Deleting and adding files 



We mentioned in the last chapter how important it is to have enough room 
on your work diskette. We have two options when developing a work 
diskette. For one, we can start over with BACKUP, make a copy and delete 
the same three programs as we did a few pages ago, to free up some 
memory. 

However, when you would like to use a diskette exclusively for letter files, 
for example, if s time-consuming to go through this copy/unprotect/delete 
process over and over again. GEOS allows you to copy individual files 
from diskette to diskette, and therefore let you make your own personalized 
work diskettes. To leam how this is done, well put together a diskette 
called Letters to contain your personal letters and notes. 

First youll need a blank diskette. Insert this blank diskette in the disk drive 
in place of the work diskette. Click the disk menu and choose the 
sub-menu item format. A dialogue box appears asking that you name the 
diskette. Type in the name Letters <RETURN>. The diskette will be 
formatted and given that name. 




Figure 7: Format window 
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Remove the newly-formatted Letters diskette, insert the diskette named 
Work 1, and click OK. To copy files to your new diskette, proceed as 
follows: 

Move the pointer to the geoWr ite icon, and click it The icon changes into 
a ghost icon. After a moment's pause, click it again. Now you can move the 
icon around. Youll remember this from Chapter 1.2, when you dragged 
icons to the waste basket to delete files. Now move geoWrite below the 
edge of the window, and click it (press the fire button). geoWrite is now 
below the window, and the pointer is again visible. Your screen should 
look something like this: 




Figure 8: geoWrite south of the border 



You are now ready to copy geoWrite to the Letters diskette. But 
we're going to want some other files which are important to the program. 
You have three programs in the deskTop window, and geoWrite below the 
window. However, the diskette contains many more programs which are 
invisible at the moment. You may akeady know that each page (section) of 
the disk directory can contain up to eight file entries. Since GEOS normally 
displays a sector in icon form, you can see eight programs as icons at a 
time. 
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To see the rest of the programs, you must turn to the next page of the 
directory. Youll notice that the lower left comer of the window has a 
dogear, similar to the folded comers on an old book. When you click the 
folded part of the comer, the directory flips to the next page. Clicking the 
unfolded area takes you to the previous directory page. 

Before we do some page-flipping, look at the lower edge of the window. 
There is a 1 in the middle, which obviously refers to page 1. Now click the 
upper portion of the dogear. The new window is page 2, and there are a set 
of different program icons on this page. The Preference Manager is located 
here, which we talked about a few pages ago. But we aren't interested in the 
Preference Manager. Instead, we want to copy the Text Manager instead. 
This program will later allow us to "cut" sections of text, and then "paste" 
them into a text album. Click Text Manager once, then again after a brief 
pause. Move the icon to the area below the window and click again. It 
should now be below the window and next to geoWrite. 

Next we'll want to copy ^omt fonts for later use. We need to turn a page, 
but don't use the dogear this time. There is a simpler method— just press the 
desired number. To get to page 3, simply press the 3 key on the upper row 
of the keyboard. GEOS tums the page, and displays the Font page. This 
page contains all the fonts available to geoWrite — you may weU want to use 
all of them. Drag all five Font icons to the area below the window, just as 
youVe done above. 

You may wonder why we want you to copy all the font files; well, this is 
going to be a diskette for letters, and we want to be as flexible witii our text 
effects as possible. Besides, the next chapter deals with some of GEOS 
capabilities, and we'll need those fonts. 
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Figure 9: Ready to copy 



Now we have everything we need for copying. Put the new diskette 
Letters into the disk drive. Click disk, then select the item close. 
Open the new diskette with disk and the open item. GEOS displays the 
directory of Letters, which is empty (contains no icons). Youll use the 
same process you used to move the icons from the work diskette, to move 
them onto the empty window of Letters (click/pause/click). Click 
anywhere on tiie empty window. Immediately a new dialogue box appears 
asking you to insert Wo r k 1 , and click OK. 
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Figure 10: Copier dialogue box 



Insert Work 1 into the drive and click OK. After a short while a new 
dialogue box appears with the message: 

Please Insert Disk: Letters 

Exchange the diskettes in the drive and click OK. Since geoWrite is a fairly 
large program, it can't be copied in one pass, and you will have to change 
between Work 1 and Letters more than once. When you click OK, 
GEOS copies the rest of the program, and soon a new directory window 
appears. geoWrite is now part of the Letters diskette. 

Copy the Text Manager next. Click it once, pause a moment, and click 
again. Move the ghost icon to any area of the GEOS window and click it. 
GEOS asks you to insert Work 1. Change disks when you are asked to do 
so by GEOS, and soon the Text Manager will be on the Letters disk. 
Follow this procedure for the rest of the files you wish to copy. 

Before we use a GEOS application for the first time, open Work 1 now. 
Click any icon below the border, move the ghost icon back into the 
window, and click it into place. Do this with the rest of the icons. GEOS 
will understand that these files are to go onto this disk, and that you won't 
need to copy them again. 
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2.5 Applications: geoWrite 

In addition to the accessories, GEOS VL2 also includes two complete 
application programs. They are geoWrite and geoPaint. For the moment 
we'll be discussing geoWrite. 

You now should have the Letters disk in your drive. Let's load 
geoWrite. Until now, weVe had you load files by clicking the icon, then the 
file menu, then the open item from that menu. 

But there is a second, faster method of loading programs. Move the joystick 
pointer to the geoWrite icon and press the fire button twice in rapid 
succession. The program loads. Now you understand why we had you 
pause between clicks in the earlier chapters. So now we have three methods 
of clicking an icon: 

1. Single click: The icon changes color. This signals GEOS that any 
commands sent by you now concem this program. To exit this 
process, just click another icon, or any free space between icons. 

2. Double click with a pause between the two clicks: This allows 
you to move the icon. This movement is used for dragging an 
icon below the border or to the waste basket. 

3. Double-click: Selects and loads the program. 

WeVe loaded geoWrite with a double-click. After loading, a dialogue box 
appears, offering you the following options: 
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Figure 1 1: geoWrite dialog box 



Click CREATE. This tells GEOS that you want to write a new letter. 
Another dialogue box appears, asking you to enter the name of your letter. 
Enter a name — To Deb, for example. Then press the <RETOTIN> key; 
part of the "typing paper" window will appear. 

Now you can begin to write. Here's what our sample letter looks like: 
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I KfQOS j f\\Q \ adit j options j font j gt^jlo 




Mother is fine noai. She jusi: finished bokinci a famous batch of her 
aiuai'd ujinning cookies (your faMOiite). Dad is doing ujell too. He went 
fishing luith Tad and Biff. Muffy misses ijou sooooo much., even though 
she's happy to have a room of her oujn. 



Figure 12: Letter to Deb 



Youll note that a text cursor appears where the next character is to be typed. 
Press <RETURN> at the end of every line for now (i.e., the right border of 
the screen). You can type beyond the right edge of the screen; geoWrite 
only displays two thirds of the window at a time, and presently shows the 
left two-tWrds. The window scrolls to the right when you type past the right 
border, but tins tends to be confusing. We'll explain later how to work with 
the "hidden" right section of the paper. 

After youVe typed a few lines, you can experiment a bit with geoWrite's 
different fonts. Click font and then the font Roma. A second menu 
appears, showing four different point sizes: 
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[ qeos ; file j edit \ options 




Mother is fine nouj. She 
•nujciid Luinninq cookies i 
fishinq tuith Tad and Biff, 
she's happy to ha^e a i* 



* B5W 
Cory 
bujineile 
Uniuersity 



Roma 



California 



9 point 
12 point 
18 point 
24 point 



]iatch of her 
II too. He ujent 



|u sooooo much, even thouq 



Figure 13: Font sub-menu 



Try 18-point by clicking that item. The second menu, from which you 
selected 18-point, controls the size of the characters. Nothing seems to 
happen when you pick the font size, such as a window change* However, 
when you press a few keys, the disk drive runs and the characters appear in 
the selected size. 
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Jecif Deb, 



Mother is fine noai. She just finished bcikinq a fcirnous batch of her 
ciujard luinninq cookies Ojoui* faMOiite). Dad is doing tuell too. He ujent 
fishing Luith Tad and Biff. Muffy misses you sooooo much, even though 
she's happy to have a lOom of her oujn. 

Vours loMingly, Gene 

P.S. This is Mttdk, CortJ^ California and 
test but not least, UniverSltV 



Figure 14: Point sizes in GEOS 



WeVe written Gene in Roma 18-point, and a few of the other fonts. This is 
just a hint of the different possibilities GEOS offers for text processing. 
Youll find that all of these fonts are on the Letters diskette, provided 
you copied them in the previous chapter. Now you might understand why 
we had you copy them. Feel free to experiment with the fonts and point 
sizes — ^youll find you like some fonts better than others. 

To exit geoWrite and retum to the deskTop, select the file menu and the 
quit item. A dialogue box appears and says: 

Please insert a disk containing the deskTop 

Youll recall that we didn't copy the deskTop over to the Letters 
diskette. We did this to leave as much disk space as possible for text If you 
prefer, you may copy this file to the Letters diskette later. For now, 
though, insert Work 1 into the disk drive and click OK. deskTop will soon 
appear. 

Our first encounter with GEOS is now complete. We hope youVe enjoyed 
it. In the coming chapters we will systematically guide you through the rest 
of GEOS. 
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GEOS in detail 



You have completed your first steps with GEOS, and have even seen a few 
of its features^ This chapter contains systematic description of the programs 
which make up GEOS, First well describe the window layout, then the 
menu and sub-menu items (where applicable). Finally, well discuss how 
you use the program. 



3.1 deskTop: The window 



An important part of the GEOS concept is the deskTop. For a long time, the 
primary mass-storage device for the C-64 was the DATASETTE. Thus the 
LOAD and SAVE commands defaulted to device number 1 — the cassette 
drive — ^rather than the disk drive, device number 8. GEOS uses the disk 
drive exclusi vely. Since GEOS is supplied with every new 64C, the days of 
the DATASETTE are numbered. 

deskTop simplifies diskette access on the '64, saving you time and effort. 




Figure 15: The deskTop window 
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The topmost line of the deskTop window is the command menu. Each of 
the terms in the command menu represents a sub-menu^ which is called by 
clicking its respective word. The individual choices in this sub-menu are 
known as items. The first two lines in the deskTop window comprise the 
title line and the info box. The title line contains the diskette name. The 
info box contains the number of files on the diskette, the amount of space 
used, and the amount of unused space that remains. 

The info box also has a small box containing a smaller black box in the 
upper right comer. This box is the close icon. Clicking this box closes the 
diskette, just as if you clicked close in the disk menu. Youll find this 
box frequently in GEOS windows. For example, the info box has a close 
icon, which lets you save information and exit the window. The opposite of 
the close icon is the diskette icon, at the upper right comer of the screen. It 
is labeled with the name of the diskette. When you click this icon, the 
diskette opens. The diskette is black when a diskette is opened, and 
becomes a ghost icon with a question mark when closed. 

The rest of the screen beneath the menu are called GEOS windows, and 
display up to eight diskette file entries per page. The pages are flipped by 
clicking the dogears in their lower left comer. Clicking the "fold" advances 
to the next page, while clicking the comer pages backwards. Pages can also 
be turned by typing in the page number from the number keys on the 
keyboard. Tliere are two icons at the lower right section of the screen: A 
waste basket and a printer. To print a text file, you don't have to access 
geoWrite first— just click the icon that represents your text file and the 
printer icon to print. Drag the icon over to the waste basket and click to 
delete. The icons indicate a filetype. 
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GEOS uses the following filetypes (if you won't be using your own 
programs with GEOS, you can skip this): 

1. System file: Important system programs like GEOS KERNALand 
system data like photo scraps. 

2. Program file: Applications (geoWrite), accessories (Preference 
Manager) and setf-starting machine language or BASIC programs. 

3. Data files: Documents (text/pictures), font files, non-GEOS data. 

4. Interface files: Programs/data for various printers or input devices. 

5. Non-GEOS files: Not created by GEOS, or altered programs and 
data in GEOS format They're identified by the C= symbol. 
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3.2 deskTop: menu and items 



Now well explain the functions of the menus and sub-menu items. The 
menu is listed first, followed by its respective sub-menu items: 



qeos 


file 




disk 


special 



gees: 

This menu contains commands to display program information, specify 
input and output devices, and select accessories: 

gees info: 

Displays a window with the names of the authors of GEOS. 

deskTop info: 

Displays a window naming the progranmier who designed the deskTop. 

select printer: 

Lists the printer drivers available on the diskette. Choose a printer driver by 
clicking tiie desired printer. The name changes color. The printer driver is 
installed when you click OK. 

select input: 

Similar to select printer, except this allows you to select input 
devices. At the time of this writing, only the JOYSTICK driver is available 
for joystick or mouse. Other input drivers are planned, e.g. for lightpens. 

preference manager: 

Displays the user-specified parameters (screen colors, pointer speed, time, 
date, etc.). 

notepad: 

A 127-page notepad onto which you can enter conmientary or notes. These 
notes are saved and reloaded with the GEOS system. 

photo manager: 

An online "photo album". Here you can store documents on album pages, 
and "cut" and "paste" them to use with other documents or text 
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text manager: 

Similar to photo manager, except it works with text You can create a 
text album of frequently-used texts and "paste" these into other texts. 

calculator: 

An onUne pocket calculator with the commonly-used math functions. 

alarm clock: 

An online digital clock with an adjustable audio alarm. 



file: 

This menu contains all the commands applicable to individual files 
(programs, letters, pictures, etc.). 

open: 

Loads a program. Trying to load a non-program file (e.g., printer drivers) 
will cause an error. Exceptions to this rule are document files and albums, 
which load after automatically loading the application program (for instance, 
opening a text document file first loads geoWrite). 

duplicate: 

Copies the selected program to the same diskette. You are asked to enter a 
name for the duplicate file, followed by a <RETIJRN>. 

rename: 

Changes the name of a file. A dialogue box appears containing the old 
filename. Enter a new filename followed by <RETURN>. 

info: 

All GEOS format files have an info box. When this item is selected, a 
dialogue box is opened. Clicking the write protect box activates (black) or 
deactivates (white) the write protection. You can enter your own notes or 
description in the area below the write protect box, and this text is saved as 
part of that file's information. 
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print: 

Documents created with geoWrite or geoPaint can be output to a graphic 
printer (usually a dot-matrix printer). Be sure that you have previously 
selected the correct printer driver using select printer. 




Figure 16: Files arranged by SIZE 



view: 

deskTop normally displays files as icons. This menu allows you to change 
the format of the display. The files can be displayed by name rather than 
icon. However, you can move and select files only if they are displayed as 
icons. After displaying these files in one of these formats, return to icon 
mode to continue your work. 

by ICON: 

Displays the files as icons from left to right and top to bottom, in 
the order they are stored on the diskette. 

by SIZE: 

Displays file entries according to file size, starting with the largest 
to the smallest. 
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by TYPE: 

Displays the files according to GEOS filetype. Filetypes can be 
found in the info box. 

by DATE: 

Displays the files according to date. Every GEOS file has a date. 
The files are displayed starting with the most recently-opened file. 

by NAME: 

Arranges the files in alphabetical order. 

Since GEOS can only display only eight file entries at a time, you can use 
the scroll box to see tiie otiier entries. A scroll box has two arrows. Clicking 
these arrows scrolls the list up or down. Holding down the fire button 
scrolls the list automatically. 



disk: 

This menu item contains all conmiands involving access to an entire 
diskette. 

open: 

GEOS "opens" the diskette found in the disk drive. The pertinent diskette 
data appears in the window (e.g., diskette name, free memory, etc.). 

At the same time GEOS tests the diskette for GEOS format If the diskette is 
not in GEOS format, the system asks if the diskette should be converted. 

This has nothing to do with the FORMAT command, which completely 
erases and reformats the diskette. In conversion, GEOS writes another 
sector to this diskette which notes the files outside the window border. This 
border is used when copying individual files, as youVe already seen. Thus, 
GEOS can have icons outside the lower border only when the diskette is in 
GEOS format. 

close: 

Click this conmiand before exchanging diskettes. Once a diskette has been 
exchanged, then click open. 
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rename: 

Renames the diskette. The current diskette name is displayed. You can then 
erase this name with the <DEL> key and enter a new name followed by 
<RETURN>, or cancel the command by clicking Cancel. You can avoid a 
lot of confusion by giving your diskettes different names. 

copy: 

Copies the contents of the current diskette to another diskette. You'll be 
asked to insert the destination diskette. The destination diskette should be 
either a blank diskette, or a diskette whose contents are no longer needed. 

After youVe inserted the destination diskette and clicked OK, GEOS reads 
the name of the diskette. If the diskette is unformatted, GEOS asks if the 
new diskette should be formatted. 

Once GEOS has the name of the destination diskette, it asks you to insert 
the source diskette (the one from which you wish to copy), and after you 
click OK, asks you to insert the destination diskette. GEOS will refer to the 
two diskettes by their names, not simply SOURCE and DESTINATION. 

The copy command is meant mainly for the user with two disk drives. If 
you only have one drive, then this command is not worthwhile to you, since 
you would have to exchange disks 30 times for a full source diskette. 
You're best off using the BACKUP program — ^it requires only three passes. 

add drive: 

This command allows the two-drive GEOS user to activate a second disk 
drive. The individual steps needed are described in a window. Turn off the 
previously-used drive, and turn on the second drive. Follow the directions 
in the window. The second disk drive is assigned the device number 9, and 
is referred to as DRIVE B. Now turn on the original drive, which is 
DRIVE A with device number of 8. 

validate: 

This command "cleans up" the diskette. Sectors of the diskette that do not 
contain valid data are freed for subsequent use. 

Warning: A GEOS file takes up more sectors than a non-GEOS file. These 
added sectors are not recognized outside of GEOS by the VALIDATE 
command. Never use the normal C-64 VALIDATE command with a GEOS 
diskette. If you do this, immediately load GEOS and execute a GEOS 
validate. 
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format: 

GEOS asks you to enter a name for the diskette followed by <RETURN>. 
The diskette is automatically formatted in GEOS format 



special: 

This menu contains three conraiands that bypass GEOS, 

BASIC: 

This conmiand exits GEOS and retums you to the BASIC interpreter. To 
reboot, insert the original GEOS diskette and press the <RESTORE> key. 

reset: 

This item re-initializes GEOS. The important data values are reset to their 
default values, and the current diskette is opened. You might try to use this 
item when youVe forgotten to perform a diskette change, and youVe stuck 
in an error loop. 

Q-link: 

This command connects you to QLINK (QuantumLink), designed for 
on-line conraiunications. It allows C-64 users with GEOS and a modem to 
talk to the world through telecommunications. 
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33 deskTop: Functions 



In addition to the commands in the GEOS command menu, there are also a 
number of functions to make your work simpler for you. Some of these 
functions, such as copying, deleting and clicking files, and different click 
items, are already familiar to you. Let's take a closer look at these functions. 



33.1 deskTop functions perfoimed with icons 

You can close tiie current diskette by clickmg on tiie close icon in tiie titie 
line. This icon looks like a tiny cassette. The icons disappear, and the 
diskette icon on the right side of tiie screen becomes a ghost icon, with a 
question mark at its center: 




add dfiMe 

Mciiidate 

foimcii: 



Figure 16.5: Diskette ghost icon 



When you click the question mark inside the diskette icon in the right comer 
of the screen, the diskette is opened. No harm is done if you forgot to 
close the diskette and click open again to open another diskette. Ifs 
enough to just click the icon directly. 
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In the lower comer of the screen is the printer icon. If you select a document 
file icon and then drag its ghost icon to the the printer icon, a printout of tihe 
file is produced. 

To the right of the printer icon is the waste basket. To delete a file, you 
simply drag the desired file's icon to the waste basket. If tihe error message 
WRITE PROTECT ON appears, you must go into the info box (click the 
info from file), click the square to the left of the write protect box, and 
then retry the delete operation. 

The dogear in the lower left comer of the GEOS window is used to view 
multiple pages of the directory. Clicking it advances the window to the next 
page. Clicking the "unfolded" comer displays the previous directory page. 



33.2 Keyboard 



Press keys 1 through 9 on the top row of the main keyboard to select the 
directory pages. To go to page 3 of the disk directory, press the <3> key. 
GEOS tums to that (Rectory page. 



3.3.3 Clicking 



You can click GEOS icons with the joystick fire button in the following 
ways: 

Simple dick: 

The icon changes color. The icon is then ready for different operations such 
as looking at the info box or printing the file. You can exit a simple click 
by clicking any other icon, or by clickmg the blank area outside of tiie icon. 

Two clicks: 

Click, then pause briefly (at least a half-second), then click again. This 
clicking selects the icon, and allows you to move it anywhere around the 
screen, such as outside of tfie border. You can get out of this mode by 
clicking again. 
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Clicking an icon: 

Depending on the situation, a click can have different results (print, delete, 
move below the border). Clicking again returns the icon to its original state. 

Double-didc: 

Double-clicking means very quickly pressing the fire button twice without a 
pause. The double-click opens a file, and automatically opens the 
corresponding application program. 



3.3.4 The remaining functions 



Copying: 

When you click a file twice and drag it below the window border, you can 
then copy it. Insert the destination diskette and open that diskette. Now 
you can move the icon into the new GEOS window and click it there. 
GEOS prompts you to change the diskettes as needed until the file is copied. 

The border is not only used for copying programs — ^it can also be used for 
changing the order of programs on the diskette. You can have up to eight 
files below the border. If you want to change the order of the icons, move 
the icons below the border and then drag them back into the GEOS window 
in the desired order. The order in which the icons appear represent their 
position on the diskette. If, for example, you want to switch geoPaint (3rd 
position) and BACKUP (7th position), click each file, drag each file below 
the border, then drag each icon to the desired position (geoPaint where 
BACKUP was, and vice versa). GEOS fills in free positions from left to 
right and from top to bottom. 

You can move an icon to another page within the GEOS window. Place the 
file at the space below the border, press a number, and move the icon back 
up to the page. 
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3.4 geoPaint 



3A1 Starting geoPaint 



One of the two applications included with GEOS is geoPaint. The geoPaint 
application has many extras in addition to the normal functions. You can 
create color documents from the sixteen colors used for characters and 
background. Foreground and background colors work in 8 x 8-pixel 
matrices. You can dso add text in diffcrtntfonts to the document 

geoPaint documents are set up in a standard (8.5" x 11") page format. 
Therefore, you see only a part of the whole picture. But you also have the 
option of viewing the entire document on the screen in a reduced resolution. 

You can access geoPaint from the deskTop in one of three ways: 

1. Click the geoPaint icon and open the file from the file 
menu. 

2. Double-click geoPaint. 

3. When you have a document already made, click that document's 
icon. This automatically loads geoPaint, and then the document. 

If you click geoPaint and not a pre-existing document, a dialogue box 
appears offering three choices: 

create: 

Click this item to create a new document. geoPaint asks you to name the 
document. Enter the name and press <RETIJrN>. 

open: 

Click this item to display the names of existing geoPaint documents. Since 
only five are shown at a time, the scroll box can be used to scroll through 
the listing. Note: geoPaint only shows the first 16 documents on the 
diskette. If you have more than 16 files, you may need to change the order 
of files (see Section 3.3.4). 

quit: 

Click this item to exit geoPaint and retum to the deskTop. 
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If you select create and enter a filename, the window appears as follows: 




Figure 17: geoPaint 



The topmost line to the left is the command menu, and the name of the 
document is to the right The geoPaint window takes up most of the screen 
to the right of the toolkit This is where part of the document is displayed 

The toolkit is on the left side of the screen. It contains the different tools 
available for creating and modifying geoPaint documents. Click a tool once 
to activate it Some tools require a second click to select another function. 

The current pattem is indicated in the lower left The Airbrush tool uses the 
pattern. 

The status box is to the right of the pattem. In most cases, it contains 
information about the tool being used. When you begin working with 
geoPaint, the pencil is the default tool. You can tell which tool is "active" 
because its image is darker than the others. 

The status box will display information about the active tool. To the left is 
the page map, in which there is yet another small rectangle in the upper left 
comer of the page display. 
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Note: As we mentioned at the beginning of this book, sprites do not appear 
in hardcopy. Therefore the small rectangle does not appear in Figure 17. 

This rectangle corresponds to the section of the document visible on the 
screen. Thus the upper left comer of the document is now displayed. Next 
to this display is the color indicator (small square), which shows tiie current 
color being used. The color listing to the right of the color indicator shows 
the sixteen available colors, while the arrow above this line shows the 
current color selected. 

You select a tool by pointing to it and clicking. Use the tool in the window 
page by moving the pointer to the desired tool icon, clicking to activate, 
using tiie tool, and clicking to deactivate. The pointer will change color 
when on or off. 



3.4.2 The geoPaint menu 



As already seen in deskTop, each menu has a sub-menu from which you 
may choose items. This sub-menu drops down when you click a menu. 
What sorts of functions do we have here, and what can they do for you? 

geos: 

Here you'll find essentially the same items as found in the same area under 
deskTop. geoPaint info replaces deskTop info, and displays the 
names of the authors of geoPaint. After that the accessories for the current 
diskette follow. Clicking the sub-menu selection is enough to start the 
accessory. 

The sub-items select printer and select input are not available 
here. Therefore, remember to select a printer driver before printing a 
geoPaint picture. 
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file: 

This menu contains the items that handle geoPaint documents: 

close: 

This command closes your document file. This is used when you're 
through with your picture. This does hqI close your workspace (i.e. 
geoPaint). geoPaint asks if you wish to create a new picture, open 
another picture, or quit to the deskTop. 

update: 

Normally, geoPaint does not save the changes you have made to a 
document. Sometimes you may want to save a picture to diskette. You can 
use this item to save the most current document and continue work. If you 
make a mistake later, you can click recover to return to the document 
picture that was last updated. 

preview: 

geoPaint documents are set up in a total resolution of 800 x 640 pixels. This 
gives you more room to work, and a great degree of detail. This command 
allows you to stand back to get an overall look at the document; the picture 
shrinks to let you see the entire document on the screen at a reduced 
resolution. Click OK to exit this mode. 

recover: 

This command works in conjunction with update, recover reloads the 
last-saved picture. Note: The picture currently on the screen is lost when 
the previous picture is recovered. 

rename: 

Lets you change the name of a document. The current name is displayed — 
delete it with the <DEL> key, enter a new name, and press <RETURN>. 

print: 

This conmiand works the same as the deskTop version. The entire picture is 
output to a printer. Remember to choose a printer driver from deskTop 
before using geoPaint to print 

quit: 

This command closes the file, exits geoPaint, and returns you to the 
deskTop. The last picture is automatically saved. 
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edit: 

This menu contains commands for editing documents. geoPaint lets you to 
"paste" portions of a picture into an album. You can then copy the album to 
a new picture, or merge the picture with text. 

cut: 

This command is similar to using a pair of scissors, cut removes a section 
of the picture, and once cut, the section disappears. The section is delimited 
before before cutting by clicking the edit box in tihe upper right comer of the 
toolkit. Now move the pointer, which appears as crosshairs, to the upper 
left comer of the desired section. When you click, geoPaint marks this point 
and changes the color of the crosshair. 

Moving the pointer to the lower right creates a dashed rectangle that delimits 
the box for cutting. Click this comer to fix the size of the box. Now choose 
file, and click cut. The disk drive spins, and geoPaint saves this section 
to diskette under the name photo scrap. You can use photo 
manager later to paste this scrap into an album. 

copy: 

This command is different from cut in that the delimited area is not 
removed, but simply copied into phot o s c r ap. 

paste: 

This command lets you paste the current photo scrap to any area of the 
document. The destination is specified by the edit box. If the area is too 
small, then only a portion of the document is pasted. 

paste lets you copy part of the geoPaint window. Cut or copy the desired 
area to photo scrap (using the edit box with cut or copy), move the 
geoPaint window to the desired destination area of the page (with the scroll 
box), mark the destination and then click paste. 

Remember the following when you work with these three commands: 

photo scrap can handle only one geoPaint section at a time. When there 
is already a section in that area and you cut or copy a new section, the 
old photo scrap is replaced by the new one. Thus, you can copy only one 
segment at a time to photo album. When you want to paste several 
window ranges into your album, put a section into photo scrap, call up 
photo manager and paste it in. After you leave photo manager, you 
can use photo scrap again. 
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options: 

This menu contains various items that allow you to further edit a document. 

pixel edit: 

This command allows you to create detailed documents under 
"magnification." Clicking this item displays a zoom marker with four 
comers — the zoom area. Set the zoom marker over the area you wish to 
enlarge. Click once, and the enlarged area appears in a window. Each point 
is now represented by a small square. Activate the pencil and click an area in 
the window — a point will tum "on". This is the equivalent of drawing a 
picture on paper with only dots. Click the pencil again to tum the point 
"off\ 

You can use the eraser to tum off (reset) the individual points. Click a point 
that you want turned off. The eraser removes that point Click again to tum 
that point on. You have both eraser and pencil available simultaneously. 

With a little practice, you can create extremely detailed drawings with 
pixel edit. GEOS shows the section being edited in its original size in 
the lower left comer of the window, so that you can view your work from a 
distance. The scroll bar performs another function in pixel edit. When you 
want to move the zoom window, click the scroll box in the upper left 
comer of the toolkit. The zoom window moves in the specified direction. 
The following tools are not available in this mode: text, edit box, circle and 
filled circle. 

normal edit: 

This command switches back to the normal window. 

change brush: 

geoPaint offers a total of 32 different brushes with which you can produce 
some remarkable effects. Clicking change brush allows you to select 
one of these brushes. Click the desired brush. It is outlined by a small 
square. 
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Figure 18: change brush — 32 different brushes 

Click the brush icon in the toolkit to use the brush. 

color off: 

When you have a color picture but no color printer, you can obtain a 
hardcopy printout of your drawing by clicking color off. geoPaint then 
displays your document in black and white. If you look at the options 
menu now, the fourth item will read color on instead of color off. 
Clicking this retums you to your color document. 

font: 

One of geoPainfs great strengths is that it allows you to use different fonts 
in your documents. The different fonts are chosen under options. 
Clicking an item displays another window that lists different fonts in several 
point sizes. Click the desired font and size. 
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3.4.3 The toolkit 



The toolkit offers you different desigh tools and functions. We'll explain the 
toolkit icons and functions in detail now, beginning at the top left comer, 
moving left to right and top to bottom. 



The four arrows represent the different directions in which you can move 
the section marker. Click the scroll box, and after a short time the marker 
appears in the middle of the geoPaint window. Moving the joystick moves 
the section in the appropriate direction, as long as the border of the picture 
has not been reached. As you move, the section that becomes "hidden" is 
saved to diskette, and the new section to which we are scrolling is loaded 
from diskette. When the desired section is displayed, click it. The scroll box 
has another purpose in pixel edit: clicking it lets you move the zoom 
window around the screen. 



Edit box: [LjJ 
Marked sections are needed for more than cut, copy and paste. 
geoPaint can perform many functions using an enclosed area. When you 
click the edit box, the status box shows the available commands: 




Scroll box: 





□ copy 

□ deaf 




Figure 19: Edit box 
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Enclose an area by moving the crosshairs to the upper left comer of the 
desired area and clicking. Next, move the crosshairs down to the lower 
right comer of the desired area and click again. Hie enclosed area is set off 
by a dotted rectangle. Now you can use the edit mode to cut, copy, or 
paste this enclosed area in photo scrap. Or, select one of the 
conmiands in the status line: 

mirror X mirrors the image in the Y axis (i.e. left to right). 

mirror Y mirrors the image in the X axis (top to bottom). 

in ve r t inverts the display of the enclosed area — set pixels are 
tumed off, and unset pixels are tumed on. TTiis gives 
you a "reverse video" effect. 

rotate rotates the enclosed area 90 degrees clockwise. 

rotate an area four times, and you retum to your 
original orientation. A segment just outside the 
enclosed area can end up disappearing during 
rotation. The solution is to either make the marked 
area as square as possible, or mark an area large 
enough to encompass all sections of the document. 

clear deletes the enclosed area. 

The move and copy conmiands are similar. The main distinction is that 
move physically moves the enclosed area to a different location, while 
copy leaves the original enclosed area and duplicates it at a different 
location. Be sure that the area is enclosed first. Click the appropriate boxes 
in the status box to activate these conmiands. To execute the command, 
click inside the enclosed area with the pointer. When you move the pointer, 
note that the enclosed area "follows." When you have reached the "new" 
area, click again, and the enclosed area is moved or copied as ordered. 

You can use copy to create duplicates of the enclosed area. Click the center 
of the enclosed area; the crosshair will change color. Move the crosshair to 
the new location, and click again. Presto! A copy of the copy. Do this as 
often as is required. 



Pattern FBI: 

The tool that looks like a water faucet lets you fill areas with a specified 
pattem. This pattem is displayed in a box beneath the toolkit. The area to be 
filled must be completely enclosed— otherwise the entire window will be 
filled in. Click the faucet icon, move to the area to be filled, and click. The 
area will fill in with the specified pattem. 
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Airbrush: 

The airbrush works like a can of spray paint. It sprays in the pattern 
indicated in the pattern box. 




Ruler 

The ruler lets you measure your document and determine dimensions and 
positions. When you click its icon, the status line looks like this: 




Figure 20: Ruler and lines 



You can choose your measurement in pixels or inches. One pixel (picture 
element) is the smallest point useable in a picture. Click the appropriate box. 
X, Y and distance are measured from the starting point. Move the 
crosshairs to the point that you want to start from. When you click here, the 
message reads: 

X : Y : distance : 

Measurements are taken from this point. Move the crosshairs and the 
display reads accordingly. The X measures movement to the right, and Y 
measures up or down. Distance is the distance between the starting point, or 
original coordinates, and the current position of the crosshairs. 
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Une.: □ 

This tool lets you draw straight lines. It functions basically the same as the 
ruler above. Click a starting point, move the crosshairs to the desired 
endpoint, and geoPaint draws a line between the two points. The endpoint 
can then be changed to any degree, which erases the previous line and 
draws a new one. Once you click again, the line stays as is. Here, too, you 
can work accurately with coordinates and distance in the status line. 



Brush: \^ 
The brush icon allows you to specify one of 32 different brushes. Choose 
another brush by selecting change brush in the options menu. In 
addition to the different sizes and forms, there are a few brushes used for 
special effects. Experiment with them. Try out the brush in the bottom row, 
ftfth from the right — ^youll get a multiple line: 



qeos i file j edii: \ options j fonts 





Figure 21: Repeated effect with brush 



Pencil: 

This tool is the default for geoPaint. You can draw freehand with this tool. 
Move the pointer to the window and click it. The pencil draw a single dot. 
Moving the pencil after you click it draws a line. Click again to turn off the 
pencil. 
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Double-clicking the pencil switches to pixel edit mode. As with all the 
tools, you can change the color of the pencil. 



Eras^ 




The eraser removes lines much like a rubber eraser, but you don't have to 
rub it back and forth as you do with a real eraser. You can erase the entire 
geoPaint window by double-clicking the eraser icon. We've found that this 
doesn't occur instantly. Sometimes you have to double-click the eraser 
several times to wipe out the desired area. It seems that when you 
double-click geoPaint quickly, the second click doesn't register. Try to 
double-click a little slower than usual. If you have problems and want an 
altemative, mark the entire geoPaint window off with the edit box, and click 
clear in the status line. Double-clicking in pixel edit erases only the 
range visible under the zoom window. 



One of geoPaint's great strengths is the number of fonts and type styles you 
can use within your documents. For example, it's extremely simple to do 
technical drawings thanks to feature. When you select the font and font size, 
and you click T for Text, the status line looks like this: 




Figure 22: Text processing with GEOS 
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You have text control almost comparable to geoWrite. Five type styles can 
be combined: Bold^ Italics, Underline, Outline, and 
Reverse. Each variation is selected by clicking its box in the status box, 
and clicking again to deactivate, plain text retums you to the default. 

When you have the desired combination, you must mark off a text window, 
i.e. determine where the text will be written. You can write this text in the 
window as you do in geoWrite with word wrap, etc. Maybe you marked a 
larger text window than you needed. If you have ah^ady clicked T, move 
the pointer to the upper left comer of the desired text area. When you move 
the pointer to the lower right comer of the marker, the edit box becomes a 
dashed rectangle surrounding the text. Click when the text window is die 
desired size. A text cursor appears at the upper left comer, and you can 
enter text When the text is ready, you can change the text as follows: 

You can make changes to the font as youVe typing in text. The text in the 
window changes accordingly. You can change text to Reverse, or change 
Roma to Un i ve r s i t y , for example. 

You can move the window to another location on the screen and change the 
size of the text window. Move the pointer to the position of the new upper 
left comer of the window. Click once. The window moves to that position. 

You can change the size and form of the window. geoPaint redraws the text 
in the new window. If the window ends up being too small, then the entire 
text may be invisible, and dependent upon the widtfi of the window, may be 
divided into more lines of differing widths. But you can change the new 
format of the text. To finish this procedure, close die window by clicking 
the T (text) or any other tool icon. The text region vanishes. 



Rectangle: |D 
This tool lets you quickly and easily draw rectangles of different forms anc 
sizes. Click the tool. Move the crosshairs to the desired upper left comer 
position, and mark this comer with a click. Now move to the lower right 
comer. geoPaint will draw rectangles as you move. When you are satisfied 
with the result, click again, and the rectangle is complete. 




Filled rectangle: 

This function works the same as the rectangle described above, except it is 
filled with the pattern displayed in the pattern box. 



55 



Abacus Software 



GEOS Inside and Out 



Qrde: 




After choosing this tool, move the pointer to the center point of the circle 
and click. Then move the pointer to any point on the radius and click. 
geoPaint draws it immediately. 



geoPaint allows you to choose from sixteen colors for the drawing or 
background color. When you click color, two color lines appear in the 
status box. The upper line represents the drawing colors. The lower line 
represents the background colors. The arrow in each line points to the 
current choices. To change to another color, give a single click. 

Make the point color different than the background. When you change the 
foreground color, every newly set point will be that color. The back- 
ground color must be changed manually. For this reason, there is a square 
beneath the color as a tool. When you drag it to the drawing surface and 
click, the background area changes into the desired color. You can remove 
the square with another click. 

There is a problem with color selection, due to a peculiarity of the '64. In 
high-resolution mode (in which geoPaint uses to draw documents) the 
foreground and background colors can only be set in blocks of 8 x 8 pixels. 
Thus the background color depends to a great extent upon the size of the 
square being changed to the new color. You may be thinking, "Okay, but I 
can set every new point in the foreground in different color — ^why not the 
background?" 

When you change the colors of set points and use different colors for 
different points within a block, these points may change to one color, since 
the 8 X 8 block interferes with the color selection. 

You should keep in mind this color selection limitation — ^the fact that you 
can only change color from block to block — ^when you are developing 
colorful graphics. Try to pre-plan different graphics so that multiple color 
changes don't occur within the same 8x8 block. If it does happen, then 
you can always move the block to another area. 



Filled cirde: 

Same as above, except the circle is filled with the current pattern. 




Color: 



color 
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Undo: lUndQl 

This command allows you to recover a previous picture. (Your other option 
is the recover command from the file menu, discussed earlier). If you 
don't like the line youVe just drawn, or you don't like the range you just 
marked off, Undo reverts to the most recent command. You cannot Undo 
commands from the menu. You must click Undo immediately after the 
erroneous command is performed. When you have drawn a bad circle, and 
then used the eraser, but change your mind and click Undo, the circle 
doesn't get erased — ^the eraser just disappears. However, undo can be a 
lifesaver. 




F^m box: 

The pattern box is not exacdy a tool. Rather, it displays the current pattem 
selected from pattern. To choose another, click the pattem box, and the 
available patterns appear. Simply click to choose from one of the 32 
patterns. 




Figure 23: Pattem box with 32 pattems 
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3.5 geo Write 



3.5.1 Starting geoWrite 

The geoWrite word processor is the second application available to you in 
GEOS V1.2. It has a number of features that set it apart from other word 
processing programs. 

First, geoWrite prints text with proportional spacing. This means that the 
character "I" is more narrow than a "W". Proportional spacing gives your 
geoWrite document a more professional look. 

geoWrite lets you use several different fonts, point sizes and type styles. 
geoPaint documents can also be added to geoWrite text documents. 
Like geoPaint, geoWrite can be loaded in one of three ways: 

1) Click the geoWrite icon once, then click open in the file 
menu. 

2) Double-click geoWrite to load it directly. 

3) open a text document file created in geoWrite. geoWrite is 
loaded and then the selected document file is loaded, so you 
can inmiediately edit the file. 

When you choose one of the first two items for loading, a dialogue box 
appears offering you three options: 

create: Create a new geoWrite document. 

open: Open an existing geoWrite document. geoWrite displays 
the first five names of a total of sixteen allowable files in 
a window. Click the desired name, and then click open. 

qu i t : Returns you to the deskTop. 
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When you click create, the screen looks like this: 



f qeos 


file j edit j options 


font i style | 


1 It 


ip===== Commodore 







Figure 24: The geoWrite window 



The command menu is in the upper left half of the topmost line. The page 
number in approximately the center, which at the moment reads 1, is 
displayed. Next to this youll see the scroll box (two arrows) and the title 
box. 

The next line down is the position line. This corresponds to the bar on a 
typewriter that is used to set the left and right margins and tab positions. 
The rest of the screen is the geoWrite window. It shows part of a page 
which you can edit. The position of the geoWrite window on the page is 
indicated by the small rectangle within the page display. It is currently at the 
upper left comer. Youll also see your text cursor at the upper left comer of 
the geoWrite window. It indicates where the next character will appear 
when you type it. 
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3.5.2 The geoWrite menu 



As weVe seen at the deskTop, selecting an item from the command menu 
displays a drop-down sub-menu from which you make your selection. 
What are these items in these sub-menus, and how do they work? 



gees: 

This menu lists the names of the programmers who wrote geoWrite. The 
accessories that are currently on the diskette are also listed. Click the desired 
accessory to load it. 

You cannot select printer or select input in geoWrite. If you 
plan to do any printing, you must remember to select the necessary printer 
driver from the deskTop before loading geoWrite. 

file: 

This menu contains all the commands applicable to files (your texts). 

close: 

This closes a document file. The file is closed, but geoWrite is still active. 
You can use create to start a new docimient file, open to call an existing 
file, or quitting to the deskTop. 

update: 

geoWrite doesn't store document file changes to diskette immediately. 
Listead, this happens when you scroll to anoSier section of the window or 
when you are done working on your document. It's wise to occasionally 
save the current changes to diskette. For example, when you want to change 
the contents of a document file, save the current file to diskette with 
update before experimenting. Then if you make a mistake, you can 
always recover the previous version. 

preview: 

geoWrite documents are set up in an 8.5" x 1 page format, even though it 
is not always visible. Use the preview command to view the entire page 
onscreen — it is displayed as a miniature page at reduced resolution. The 
letters won*t be readable, but preview will at least give you an idea of the 
page layout.. 
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recover: 

This command works in conjunction with update, recover restores the 
last update to the screen. Warning: The current document file displayed 
on screen is irretrievably lost. 

rename: 

This command lets you change the name of the document file. The current 
name is displayed in a dialogue box. Delete the old name with the <DEL> 
key and enter the new name followed by <RETURN>. 

print: 

You'll remember this conraiand from the deskTop. Your entire geoWrite 
document is output to the printer. Remember to first select printer in 
the deskTop before you using this command. 

quit: 

This closes both the document and geoWrite, and returns you to the 
deskTop. 



edit: 

The following editing commands should be familiar to you from the 
sections on the photo manager and text manager. geoWrite allows 
you to keep often-used text passages in a text album, copy them from this 
album and "paste" them into a different document file. You can also paste 
geoPaint documents and other items from your photo album in your texts. 

cut: 

cut allows you to remove a segment from a geoWrite document. This 
works much like cutting a section (block) from the newspaper with scissors: 
The section disappears from your text Unlike geoPaint, however, blocks of 
text aren't marked with a rectangle. Rather, you mark a block as follows: 

Set the pointer on the first character of text. Press and hold the fire button. 
Drag the pointer to the end of the block and release the fire button. The 
block is indicated by a color bar. If the block consists of several lines, then 
you mark the beginning (holding down the fire button) and pull the text 
cursor down a line at a time rather than a word at a time. Once youVe 
marked the block, you can proceed to the next command. You can 
"unmark" the block by clicking any other "unmarked" area of the page. 
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A marked block looks something like this: 



1 9<iQg j filsa j «adit j options j ionK \ | i |^ | 



fishing luith T^^ and; Biff: Muffy; misses -you sooooo . much, euen thoug 



STies happy to hoMS ci room or her ocun. 



Figure 25: Marked geoWrite document section 



Now move the mouse to file and click cut- The disk drive runs and 
geoWrite saves this section of text (block) to diskette with the name text 
s crap- You can later paste this into a text album using text manager. 

copy: 

This conmiand works very much like cut, but the block is not removed 
from the geoWrite document. It is simply copied to text scrap. 

paste: 

This conmiand lets you paste the current text scrap to a new location. 
You can also paste graphic documents from geoPaint. When you click 
paste, another dialogue box appears and asks whether you wish to insert 
text or graphics. The range is pasted at the current text cursor location. This 
is what it looks like when we insert a graphic into a document file: 
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so I ndjijsted your chart to shoiu that oil your partij money's really 
going into housing. 



Please note the following when using these three commands: 

text scrap only has room for one extract at a time. If you cut 
or copy a geoWrite document passage, but text scrap already 
contains a passage, the previous passage is replaced by the most 
recently cut passage. By the same token, you can paste only one 
text passage at a time to the text album. 

If you wish to paste several geoWrite document segments, you'll 
have to paste a segment into text scrap, load the text 
manager and paste in the segment. Once you leave text 
manager, you can cut another text scrap and repeat the 
operation. 

A geoPaint document which has been pasted in geoWrite document 
may be deleted like text. Position the text cursor at the first 
character following the geoPaint document, and press <DEL>. 
Unfortunately, you can't write anything in geoWrite inside of this 
inserted geoPaint document 




Figure 26: Graphic in geoWrite document 
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options: 

This menu has essentially the same commands as in the page format section 
of geoPaint. 

previous page: 

This command goes back one page in the document (works only if your 
document has more than one page). 

next page: 

This command goes forward one page in the document. Again, the 
conmiand only works when more than one page exists. 

go to page: 

This command displays a specific page in a document. Click this command 
and enter the desired page number in the document 

hide pictures: 

This command is very important when you include geoPaint documents in 
your text document. That's because they are loaded from diskette, rather 
than stored in text memory. When you want to hide them, use this 
command. A rectangle replaces the geoPaint document. The frequent 
loading processes stop, and you save a lot of time: The document will be 
printed without graphics. But remember, this command functions only 
under geoWrite. 

page break: 

The final item in the options sub-menu lets you mark the end of a page. 
A horizontal line is drawn at the text cursor location and the text cursor is 
advanced to the next page. You can remove the page break by moving the 
cursor to the upper left comer of the page break and pressing <DEL>. 
geoWrite asks whether you wish to delete the last character of the preceding 
page (the last character is the page break). Click YES and the page break 
is gone. 

Frequent use of page break can save you a great deal of time. When you 
must insert text in a multiple-page file, the altered text often spills over to the 
pages that follow when there is no room on the current page, page break 
lets you reformat the pages to make room. 
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font: 

One of geoWrite's great strengths is that it allows you to use multiple fonts 
in your texts. When you click font, a number of fonts appear. Selecting 
the font calls up a list of point sizes. Click the desired point size. The 
current font is marked by an asterisk. 

style: 

This menu item contains the different type styles (variants) which you can 
select individually. The active type styles are marked by asterisks, plain 
text tums off all type styles and retums you to normal text. 



3.53 Entering text 



Using geoWrite, text is entered simply by typing it in. The text appears at 
the text cursor's present position. geoWrite displays the leftmost two-thirds 
of the text — when you reach the right border of the screen, the document 
scrolls to tiie left, allowing you to see its rightmost two-thirds. 

You can erase the last character typed by pressing <DEL>. The text cursor 
deletes the character to the left. When you press the <DEL> key repeatedly 
until youYe at the first character of a line, the text cursor moves to the 
preceding line. The cursor keys work differently than you'd expect. They 
delete characters in geoWrite, like the <DEL> key. To move the text cursor 
within a document, set the joystick pointer to the desired area and click. 

geoWrite has word wrap. This means that words are not separated at the 
end of a line, as with a typewriter. If the word is too long to fit at the end of 
a line, it is "moved" to the beginning of the next line. 

When you want to add to or delete from an existing section of text, move 
the joystick pointer to the desired area and click. Now when you type in 
characters, they are inserted at the new text cursor position. The existing 
characters are moved to the right to make room for the new text Text to the 
left of the cursor is deleted with <DEL> or a cursor key. All of the keys 
repeat using geoWrite. Instead of repeatedly pressing a key, just hold it 
down; the key repeats automatically. 

To insert a blank line, move the text cursor to the beginning of where you 
want the blank line (move the pointer, and then click), then press the 
<RETURN> key. The text will move one line down from the cursor, and 
the blank line will appear. To remove a blank line, move the text cursor to 
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the beginning of that blank line and press <DEL>, It is also possible to 
move a page break this way (geoWrite draws a line signifying tiie beginning 
of the next page). Set the text cursor past the last character before the page 
break, and press <RETURN>, The break moves down one line, and you 
now have a new blank line. 

When you move the pointer to a point past the end of your text, the cursor is 
placed at the first blank area following the text. You cannot move tiie pointer 
beyond the end of your text. To move the end of text downward, press the 
<RETURN> key repeatedly. Another method is the tab, which well 
discuss shortly. 



3.5.4 Formatting Text 



When you want to end a line, press the <RETURN> key. This will end the 
current line and move the text cursor to the beginning of the next line. 

Now we come to the elements of text formatting. The position line at the top 
of the window is for text formatting. Typewriters have a similar line for 
setting left and right margins and for settmg tabs to jump across a number of 
colunms at a keypress. 

The position line has two M markers for setting your margins. The first is on 
the left side of the position line. Click it, move it to the desired position, and 
your left margin is set. This means that text lines will start at tiiat position. 
The other marker is set at the far right of the position line. You can't see it at 
the moment, because geoWrite only displays two-thirds of tiie window at a 
time. Move the pointer to the right edge of the window. The window will 
scroll to let you see the right portion of the window and the other M marker. 
Click it, move it to the desired position, and click again. geoWrite will 
immediately adjust to the new right margin setting. 

During text entry, you should set your left margin at 1 and the right margin 
at 5 (the numbers are on the position line). This makes the entire text line 
visible onscreen (important in proofreading), and saves you time since you 
don't have to scroll back and forth between screens. When your text is 
complete and ready, then you can move the left and right margins to their 
proper positions for printout. 
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You can set up to eight tabs in the position line. Point to the spot on the 
position line at which you want a tabulator set, at the same height as the M 
markers. When you click this spot, the disk cJrive will run, and an pointer 
(the tab marker) appears. A tab can be clicked and moved to another place 
on the position line. To remove a tab, click it and move the arrow up to tiie 
numbers on the line. If you click again, it is deleted. 

How do you use tabs? You press and hold down the <CTRL> key at the 
top left of the keyboard and then the i key, or <CTRL> i. If the text cursor 
has not reached the end of a line, it jumps to the next tab column. 

The geoWrite window displays only a small part of your entire text. You 
can move around the page in several ways. For one, when the text is wider 
than the screen width and you can no longer see both margins, you can 
overlap between screens witfi the pointer. Just move the pointer to the right 
or the left borders. You can also move up or down the window by clicking 
the scroll box arrows. This moves the text in the geoWrite window up or 
down one line. Holding down the fire button scrolls geoWrite line by line. 

The page display can be used for further position changes. As you know, it 
displays the current page number, and is located to the left of the scroll box. 
In addition to the page number, the display also shows the relative position 
in the document as a small black square. Click this rectangle, slide it to the 
desired area of the document page and click again. After a few moments, the 
geoWrite window displays the new text location. 

Finally we come to the PAGE commands, which let you move to a specific 
page in the document You can mark passages in geoWrite and use different 
commands in these blocks. Move the pointer to the beginning of the passage 
(the first character), and move to the last character while holding down the 
fire button. The marked block will tum dark. You can now do one of the 
following with this block: 

• cut the text and make it a text scrap 

• copy and make it a text scrap 

• Delete it with the <DEL> key 

• Replace this block with new text, just by typing in the new text. 
Pressing any key automatically deletes the block. 

• Select another font, type style or point size by clicking the 
selection. If the altered text takes up more room than before 
because of larger point sizes, the text following the block is 
moved down to make room for the new font. 
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3.6 Accessories 



With the two applications geoWrite and geoPaint, GEOS has a number of 
accessories that can make your work easier. The advantage of these 
accessories is that they can be loaded from an application. For instance, you 
can use the calculator while working in geoWrite, and draw graphics from a 
photo album while in geoPainL 

Youll need sufficient memory on diskette to have these accessories 
available. A SWAP file is set up on diskette. It records the current state of 
your work and stores program sections that might be overwritten by the 
accessory. When you leave the accessory, the SWAP file is reloaded and the 
program picks up from where it left off. It's very important that there is 
enough space on the diskette to maintain this file, which can be up to 15K in 
size. 

All available accessories are listed under the geos menu. A single click 
loads the accessory. If you prefer, you can double-click the accessory name 
in the geos menu, or click the accessory, then file, then open. When 
you want to leave the accessory, click the close icon (that small box in the 
upper right of the window). 



3.6.I. Alarm clock 



The alarm clock in GEOS has several advantages to it: 

• You have a digital clock available at any time. 

• You can set an exact time for the alarm to go off. 

• You can save text and graphics with the date and time, to 
quickly determine which is the most current version of a file. 

Be sure you enter the current date and time from the deskTop at the 
beginning of every GEOS session. The easiest way to do this is to use the 
preference manager, which lets you set both the date and the time. 
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When you load the alarm clock, the screen will look something like this: 




Figure 27: Alarm clock 



The center section has an eight-digit time display. The first six digits are the 
clock time in hours, minutes and seconds; the latter two figures read AM for 
before noon and PM for after noon. The items beneath the time, looking 
from left to right, serve the following functions: 

Mode button: 

This gives the time mode, in which the time is normally displayed. The 
mode button is normally a white clock on black background. The other 
mode is alarm mode, indicated by a bell, which appears when the alarm is 
set. 

Set button: 

This button lets you set the time. 
Close button: 

Clicking this icon closes the alarm clock. 

The alarm bell will appear to the right of the close icon. 
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To set the current time, move the text cursor (which should be at the P of 
PM) to the first digit by pressing the spacebar. The spacebar moves you 
from digit to digit without erasing or changing numbers. Now you can enter 
the new time. Remember that GEOS accepts only valid data. That is, you 
can't enter a 2 for the first digit, since hours can only be between 01 and 12. 
The last character may be only A or P. When you are finished setting the 
time, press <RETURN> or click the set button. 

In the same manner you can set the desired alarm time. You must be in the 
alarm time mode. Click the mode button. You can toggle back and fortfi 
between modes by pressing the <M> key. Now set the time and click the set 
button or press the <RETURN> key. An active alarm is signaled by the 
display of a bell symbol. 

To exit the alarm, click the close icon or press <SHIFT> and <Q> at the 
same time. Although youVe left the clock mode, the clock remains running 
— and the alarm is still active. When the alarm time is reached, a tone will 
sound for five seconds. 

The GEOS clock was designed for 60Hz electrical power. However, some 
European countries have 50Hz power. Because this book is distributed 
internationally, for our European readers weVe written a routine that 
corrects the timing (and keeps the clock accurate at 50Hz). This program is 
included in Chapter 5, Tips and Tricks, and on the optional diskette for this 
book. 

An annoying feature of the alarm clock is that you have to load it to get the 
current time. Another disadvantage is that you can't determine the alarm 
time without resetting it again. For these reasons, we wrote a GEOS 
program that displays the current time and alarm time on the screen. This 
program is also found in Chapter S and included on the optional diskette. 
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3.6.2 Calculator 



Another accessory is the calculator. This performs the usual basic math 
functions. When you load it, the window appears as follows: 




Figure 28: Calculator 



There are two ways to enter numbers or perform calculations. You can point 
to and click the desired keys with the pointer, or you can use the C-64 
keyboard to enter the numbers and operations. The keys on the keyboard 
have the following functions: 



Addition : 


+ 


Subtraction: 




Multiplication: 




Division 


/ 


Exponentiation: 


E 


Qear: 


C 


Clear entry: 


CE 


Close: 


<S] 
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For example, to compute the equation: 

3.45 X lO^x 1.123 X 10^ 

you would type: 

3.45E8*1.123E4= 

The result is: 

3.87E12 

The range of exponents can be no higher than 37 and no less than -37. 

The close icon is the dark box at the upper right of the calculator keyboard. 
Click this to exit the calculator. 



3.6.3 Notepad 



To use an "old-fashioned" desk effectively, you need a notepad to jot down 
times, notes, appointments and comments during conversation, just to 
mention a few examples. GEOS has a notepad too. It allows you to keep up 
to 127 pages of notes and store them on diskette as a notebook. Thus, the 
notepad and notebook go together. 

After loading the accessory, a window displaying dogear pages appears. 
Unfortunately, it is impossible to directly access pages with the notepad as 
with the deskTop. Perhaps this drawback will be eliminated in a later 
version of GEOS. 

You can enter your text into the notepad as usual. The <DEL> key deletes 
the last character typed and moves the text cursor one character to the left. 
YouVe already seen this from geoWrite. We have already typed in a page 
on our notepad, so you can see how it works: 
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Figure 29: Notepad 



When you are finished reading or writing your notes and want to exit the 
program, click the close icon in the upper right comer of the window. When 
you want a fresh notepad, you can move the existing pad into the waste 
basket This erases its current contents, and you have a fresh notepad. 

WeVe skipped two other notepad functions that would make GEOS life 
easier. One is that a page can be deleted on a keypress. The other is that you 
can flip through pages if you so desire. 
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3.6.4 The Preference Manager 



The Preference Manager is an accessory that lets you specify certain 
program parameters (sizes, values) such as background color. These values 
can then be saved and recalled at any time. 




Figure 30: Preference Manager 



The Preference Manager window is divided into several sections. The first 
three lines to the left control the speed of the pointer. Below is a window 
that lets you change the appearance of the pointer. Later well see how it 
works. The top center specifies the color selection for the border, 
foreground, etc. Below are the two windows that let you set the time and 
date. The upper right contains the command list for the Preference Manager. 

The pointer speed controls are in the upper left comer. You can change the 
parameters and experiment until you find the "right" settings. 



74 



Abacus Software 



GEOS Inside and Out 



Fointer speed; 
acceleration: 

This control lets you set how quickly the pointer reaches maximum speed. 
When you work a lot with the deskTop, rapid acceleration is important if 
you move the pointer frequently for clicking OK, etc. Click the control bar 
knob to a new position and click again to set it. Moving the knob to the left 
slows the pointer, and moving it to the right speeds up tfie pointer. 

MAX VELOCITY: 

Here you set the highest speed at which the pointer travels after accelerating. 
Again, you'll want high speed if you frequently use the deskTop (shifter all 
the way to the right). 

MIN VELOCITY: 

This control bar adjusts the starting speed of the pointer. 

If you work a lot with geoPaint you probably want to start with a slow 
minimum velocity and average acceleration. This makes it simpler to set flie 
center point of a circle, for example. 

If you want to see the effects of the change inraiediately, click the CHANGE 
button. Well discuss the other buttons shortly, but we mention CHANGE so 
that you can see the effect 

Pointer appearance: 

The large rectangle in the lower left displays the pointer in bitmap mode, 
while the small rectangle displays it as a normal sprite. To change the 
appearance of the pointer, move the pointer into the large rectangle. This 
window's pointer works as a small pencil and eraser, similar to geoPaint's 
pixel edit mode. When you click where there is no set point, a point is 
turned "on". Clicking a point turns it "off. As you turn pixels on and off, 
you can see the results in the small rectangle. The pointer with which you 
are working does not change. The reason for this is that if you deleted all 
the points, you'd have this invisible pointer, and you*d be unable to use the 
Preference Manager any longer. TTiis is anotfier reason why alterations 
don't take effect until CHANGE is clicked. 
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Each respective range or area changes color when you click the 
corresponding button. You can choose from 16 colors. They appear in 
order as you click the button. You can "cycle" through all the colors by 
clicking 16 times. 

BORDER changes the border color. This is not the deskTop border which 
we use to copy files. Instead, it's the edge of the entire screen area. 

B . GROUND controls the color of the background, as you may remember 
from geoPaint. 

F . GROUND changes the color of the foreground, i.e., set points and colors. 
MOUSE controls the color of the mouse pointer. 

There is a limit to the choices of colors. You are not allowed to choose the 
same colors for background, foreground or pointer. There is good reason 
for this: The wrong choice could result in an invisible pointer. Then you 
wouldn't be able to read error messages, for example. 

Time and Date: 

WeVe already discussed the time and date — ^you should always set them 
when working with GEOS. We*ll just repeat the important aspects: 

Youcanchange time and date by clicking TIME SET and DATE SET with 
the pointer. Move the text cursor over the characters with the spacebar. 
They are not erased by the spacebar. Enter numbers from the keyboard. 
GEOS allows only valid input, e.g., A or P for morning or evening. When 
you're ready, and the tntiy is complete, press <RETURN>. If youVe 
forgotten and already exited the area with the pointer, the date and time will 
assume the default values. 

Remember to set the date and time to the current values whenever you start 
GEOS. The date/time data is saved along with every geoWrite and geoPaint 
document This can be extremely useful when trying to determine the most 
up-to-date version of a graphic document or text document. 
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Command buttons: 
EXIT: 

This button exits the Preference Manager, Your parameters are not 
automatically saved or executed 

LOAD: 

This button loads saved values. 

SAVE: 

Saves the current values. These are not necessarily the displayed values. 
You must activate the new values by clicking the CHANGE button. 

If the values aren't saved, the alterations are current only for the duration of 
the GEOS session. Returning to the deskTop or re-booting GEOS will reset 
the previous parameters. To retain the new preferences, be sure to SAVE 
them. A Preferences file is saved to diskette, and is reloaded when the 
diskette is later opened. 

CHANGE: 

Activates the changes. When you have changed parameters by moving the 
knob for MIN VELOCITY to the left, the pointer will move more slowly. 
Values altered with CHANGE can then be stored with SAVE. 

DEFAULT: 

This conraiand can be very useful when you wish to set all parameters back 
to the default values, i.e., back to the values used before you started 
changing the preferences with the p re f e r en ce mgr. 



3.6.5 The Photo Manager 



The Photo Manager lets you organize a collection of your best pictures and 
sections of graphics in a computerized photo album. You can later copy 
these photos from the album and paste them into text or graphics. Each 
photo album can contain up to 127 pictures. This is usually enough room 
— but make sure there is enough diskette space. The picture sections must 
be in geoPaint format. 
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Set a range with the range marker from the toolkit and click either cut or 
copy from the edit menu. This segment is then designated as a photo 
scrap, which is the name of the file created on diskette to store it This 
photo scrap file connects geoPaint and the photo manager, and 
allows a picture to be transferred. 

Note: Only one photo scrap is allowed at a time. 

When you want to load the photo manager, and you already have a 
photo album on diskette with which you would like to work, you can 
double-click the photo album from the deskTop. The photo 
manager is then loaded, along with the desired album. The altemative is to 
first open the photo manager. The following dialogue box appears: 




Figure 31: Photo Manager — starting menu 

The three choices are already familiar to you from geoWrite and geoPaint. 
You can choose create to make a new album in the photo manager, 
open displays the first five albums on the diskette; a total of 16 albimis can 
be displayed by clicking the scroll boxes. Click tihe desired name (which 
turns dark) and open to open the file, quit returns you to the deskTop. 
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When you have created a new album, a window appears and displays 
Empty Photo Album. If the album already exists, the first document is 
shown. The dogear in the lower left comer lets you flip through the pages 
of the album, and the close icon at the top of the window closes (exits) the 
album. Here is a page from our own Photo Album, so you can see the 
layout: 




Figure 32: photo manager — Graphic for To Deb 

The upper left comer is a menu with two sub-menus, file has the two 
items close and quit, quit exits the photo manager, and close 
closes the album and retums you to the create/open/quit dialogue box. 

edit offers the following items: 

cut: 

Cuts the indicated picture from your album and sets it in photo scrap. 
From there you may paste it into a text or a graphic. 

copy: 

Copies the indicated picture into photo scrap, without removing it from 
the Photo Album. 
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paste: 

Pastes the photo scrap picture into your Photo Album. The picture is 
copied into the album, and also remains as a photo s crap. 

In the lower left comer of the window (beneath the dogear) is an icon youll 
need when the geoPaint segment doesn't completely fit into the photo 
manager window. The black rectangle gives the size of your picture. The 
rectangular borders represent the window. You can click the border and 
insert 3ie picture in another range. This appears in the window. 

To help you better understand what you can do using the photo 
manager and a little paste-up, we've written a letter in geoWrite. Now 
well include a geoPaint graphic. 

Assuming you have a geoPaint document ready, delimit the range using an 
edit box, and copy the range into photo scrap. Now we load the 
photo manager and paste the Expenses document into the album. 
Then we exit the photo manager and open the existing letter file To 
Deb. Move the cursor to the end of the text (OCTOBER 1986). Now click 
the paste function from the edit menu. The result should look 
something like this: 



I qeog j i^ile I edi^ | options j font j |i 




50 I cidjijsted youi* chart to show thnt all ijjour party rnonetj!':- realliji 
qoinq into housing. 




Figure 33: Text and graphics with the photo manager 
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This text/graphic integration was not easily accomplished before GEOS. We 
should mention that the picture was made in about ten minutes. Maybe you 
can dream up more applications with GEOS. 



3.6.6. Text Manager 



The Text Manager lets you store often-used passages in several Text 
Albums, and paste these passages in new documents as needed. Each Text 
Album can have up to 127 pages, the same as Photo Albums and notepads. 
The text passages must be cut from documents created by geoWrite. Mark 
the text by setting the pointer to the first character, press and hold the fire 
button, and move the pointer to the end of the text passage. The text range 
will turn dark. 



Now click edit, then click either cut to cut the segment, or copy to 
make a copy of it. This segment is saved to a file on diskette called text 
scrap. This file may contain only one text segment at a time. It serves to 
connect geoWrite and the Text Manager, acting as the "go-between". 



[ 900^ j \ odit 1 option;? j Iront j sK^Iq 





shes happy to UQKf^ a (oora of her own. 



Figure 34: Marking text for text s crap 
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You can go from the deskTop to the Text Album, if a Text Album is on the 
diskette- The Text Manager is first loaded and then the album is opened. 
The other option is to open the Text Manager first. After a few seconds a 
dialogue box appears with the same items as geoPaint or geoWrite 
(create, open or quit), create is used to create a new album, open 
displays the first five album names on the diskette. To see the rest 
(maximum of 16 albums per diskette), use the scroll boxes and click down 
or up. Click the desired name (it will turn dark), then click open, quit 
returns you to the deskTop. 

When you create a new album, the following window appears: 



eos i file j ^i^uj \ disk j special | 

file \ edit L 5 lettef 



Emptij texi: alburn. 



is: 



Figure 35: Empty text album 



If the album already exists, the first page of text is displayed. You can flip 
through the pages using the dogear at tilie lower left comer of the window, 
or close (exit) the album with the close icon at the top right comer of the 
window. The upper left comer contains a short menu with two sub-menus, 
file has the items close and quit, close closes the album currently 
open and sends you back to the window menu create; open and quit 
exits the Text Manager and retums you to the deskTop. 
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edit offers the following items: 

cut: 

Cuts a marked text area from the album and sets it into text scrap. 
From there, you can paste it into another document 

copy: 

Copies the marked text into text scrap. Unlike cut, the original text is 
not deleted and remains in the Text Album, and is copied into text 
scrap. 

paste: 

Pastes the text s crap into your Text Album. The text is copied over, so 
you can use text scrap for other purposes (even another Text Album). 

Below is an example of marked text pasted into a Text Album, so you can 
see how it*s done: 




Mothef 

fishing 
she's h 



Deaf Deb.. 

Mother is fine nouj. She just finished b«nkin«3 a 
famous batch of her 

aiuQtd ujinninq cookie? (your favofite). Dad is doing 
ujell too. He luent 

|isJbjng ujith Tad and Biff. Muffy misses you sooooo 
:h, even though 



1 of 1 



her 
He ujent 
jn thouq 



Figure 36: Marked text in the Text Album 
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Notice that in Figure 36, the text looks somewhat different from the original 
text. For example, Love^ Gene was in a different font altogether. Text 
passages in a Text Album revert to a single font and point size. However, 
GEOS remembers the original fonts and type styles, and when you paste a 
text passage back into a document, the passage appears in its original fonts, 
type styles and point sizes. 

The lower left comer of the window, beneath the dogear, contains a scroll 
box that allows you to see documents that are much larger than the screen 
allows. Clicking either arrow scrolls through the document one line at a 
time. You can, therefore, paste larger text passages into the album. You 
don*t need to limit yoursetf to the onscreen page size. 
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GEOSAppKcations 



By this time youVe probably learned a lot about GEOS' features. YouVe 
created your first graphics with geoPaint and written documents with 
geoWrite. You may have come to the point where you are not quite sure 
what more you can do with the system — ^youVe written letters with 
interesting text fonts to all your friends, and youVe run out of ideas for new 
graphics. 

This chapter may help you see some of GEOS' capabilities and give you 
more concepts of practical applications. Not only will we present ideas — 
we'll go through the ideas step by step. In this way you'll also leam how to 
produce the effects you want with less work. 



4.1 Making diagrams with geoPaint 

You need a geoPaint work diskette with at least 30 K of empty space for 
this section (we'll refer to this work diskette as Diagram). 

You can erase the following programs to create such a diskette: GEOS, 
GEOS BOOT, GEOS KERNAL, geoWrite, TEXT MANAGER, and all the 
printer drivers that you don't need. 

Before GEOS was developed it was difficult to mix graphics and text with 
the C-64 computer. At best, it looked as though the graphics were added 
later. It is much easier to mix graphics and text to form a document using 
GEOS. We'll look at one application of this now: producing diagrams. 

You'll remember pastmg a pie chart into a document using geoWrite and the 
Text Manager. In this chapter we'll examine how you can use geoPaint to 
produced the three most common types of diagrams: 

• Pie charts 

• Bar charts 

• Line graphs 
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As an example weVe chosen a fictional expense breakdown for May 1986. 
This can be represented well by the first two kinds of charts — ^but a line 
graph does not lend itself to this kind of data. However, we created a line 
graph for the May 1986 expenditures, even though it is a poor 
representation, to show you how to create the relevant graphics for each 
type of diagram. Using the methods shown here you can produce useful 
charts for your own applications. 

Before we can represent the data graphically, we must first have it in front 
of us. Our example is the following: 



Now well start to graphically represent the data. Well start with a pie 
chart. 



4.1.1 Pie chart 



First open the work diskette Diagram and load geoPaint. Choose create 
and enter Pie May as the name of the graphic to be created. Now we can 
begin to draw the chart. 

Well start with the title. We click the T tool (Text) and then click the BOLD, 
UNDERLINE, and OUTLINE type styles. Then we type Expenses May 
1986 in the upper middle section of tihe window. 

Before we draw the circle, we must mark the center. Otherwise it is difficult 
to draw the lines needed for the pie chart. Youll notice this right away 
when you try to place the crosshairs exactly where you want the center. If 
the joystick pointer (in this case the crosshairs) moves too fast for you, load 
the preference manager and set MIN VELOCITY as far as liossible 
to the left, and acceleration approximately in the middle. Now the 
joystick pointer moves more slowly, so ifs easier to do precise work . 



Housing: 

Food: 

Car: 

Miscellaneous: 
Pgrspnal; 



May im 



25% 
20% 
10% 
30% 
15% 



Total: 



100% 
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Well use the pencil icon to draw a small cross to mark the center of the 
circle. Click the circle in the toolkit and set the marker exactly on this cross. 
If you have trouble getting the circle and the cross aligned (for example, 
you're a little too far to the left and then to the right, etc.), it helps to move 
the cross several points over and try again. 




Figure 37: Title and circle 



When youVe gotten that to work (don't worry — ^it gets much easier with 
practice!), click and move the circle so that it is located approximately where 
ours is in the illustration. It's important that the whole picture fits on the 
screen. Everything that is drawn outside the geoPaint window is lost. 

Once the circle is complete, we need to add several lines to the pie chart. 
Choose the line tool. Click the center of the circle and then move the line 
upward. A second click stops the line. Now we need to draw a section of 
pie that contains 20% of the whole. Since a quarter of the pie is exactly 
25%, the piece must be a little smaller than a quarter. By "eye-balling" it, 
you should be able to do this with no problem. 

Now draw the lines for the other percentages. If you draw a line incorrectly, 
you can erase it using the Undo function. If you don't like the way you 
divided the circle, and just want to get rid of individual lines, you can erase 
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the lines in pixel edit mode. Make sure that your lines and the circle 
remain enclosed figures — i.e. don't delete a few points from them. 
Otherwise, when you use the fill patterns, the pattems may spill into other 
areas. 

Once youVe drawn the circle and divided it into appropriately sized 
sections, you're done with the hard part. The rest is easy. Now let's fill the 
sections with different pattems. Click pattern fill (faucet icon) and then the 
pattem box. We now have 16 different pattems available. Choose the 
desired pattem, move the joystick pointer tiie the desired section of the pie 
chart, and click. The program takes care of the rest. Once you've filled the 
five pieces of pie, the result looks something like this: 




Figure 38: Chart segments with fill pattems 

To make the graphic even easier for others to understand, we can label the 
sections with their respective percentages. Click T. Then choose BSW 9 
Point from fonts and plain text in the status line below. 

Now move the pointer to the first section of pie (upper right section of 
diagram). You need to create a text window there so that the text can be 
written in it 
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Click the upper left comer of the text window and move it about half an inch 
down and to the right. It doesn't need to be too big since it only needs to 
hold three characters: 20%, The result should look like this: 




Figure 39: Chart segments with actual percentages 



When you like the size of the window (it should be a little bigger than the 
light area in our pie), click T. A cursor appears in the left part of the 
window. Now enter the three characters 2 %. If you're satisfied, click the T 
again. The text window disappears and your input is saved. You can change 
the position of the three characters by simply clicking the new upper left 
comer of the text window. (Keep in mind tiiat problems may occur if this 
comer is inside the previous window). Then click a point outside of the 
circle, move the window, and click again. 

geoPaint has created a text window there. Now you can click on the desired 
point in the piece of pie — it isn't in the window anymore. That's a bit 
complicated, but it can help us do our work. 

When you're satisfied with the layout of the three characters and have 
closed the text window by clicking T, write the other four percentages in the 
appropriate pieces of pie. 
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Now we're almost done. We just need to label the sections so that those 
who look at the chart will know what each section represents. Click 
underline in the status box. Write the items next to their chart segments. 
The results should resemble the following: 




Figure 40: Finished pie chart 



You can also add lines from each item to its section of the circle. Now your 
pie chart is done. It's a good idea to put it in a photo album so that you can 
paste it in various texts. Delimit the entire figure with the edit box and 
choose copy from the edit sub-menu. After a few seconds, the section is 
stored in the phot o s crap file. 

If you want to paste it in a photo album immediately, load photo 
manager from the geos menu. If you don't have an album yet, create one 
with the name Graphics. When the photo manager shows you the 
empty album, choose paste from edit, and your pie chart will appear in 
the window, quit returns you to the geoPaint program. 

If you now want to create a bar chart using these percentages, close the 
Expenses May 198 6 file (click file and then close). The next 
section describes how to create a bar chart 
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4.1.2 Bar chart 



Click create and enter Bar Chart as the name. With the last example, 
we made sure that the pie chart fit in the geoPaint window. That makes the 
work a lot easier, but has the disadvantage that the items must be fairly 
small. Now we want to make a figure larger than the window. 

First we need to decide how large we should draw the chart. Since the 
largest percentage value from our data table on page 88 is only 30%, we 
don't need to extend the scale to 100%. We settled on a bar chart that goes 
from 0% to 50%. We also decided to represent each 10% increment with 40 
pixels. Each bar should be 50 pixels wide. We also included another 20 
points per bar to create a three-dimensional effect. With these criteria, we 
see that the vertical axis must be 5 x 40 = 200 pixels long and die horizontal 
axis must be 5 x (50+20) = 350 points long. The bar chart won't fit in the 
geoPaint window. 

Now we can start drawing. The page marker shows the upper left comer of 
the geoPaint window. Well put the vertical axis about an inch from the left 
boundary so that well have enough room to write the percentages. Click the 
line tool and place the crosshairs in approximately the middle of the screen 
(but keep it an inch from the left border). Then move the line until you reach 
the bottom of the window, then click it there. 

We want to move the geoPaint window as little as possible, since doing this 
takes a lot of time. We won't finish drawing the vertical axis now 
(otherwise we'd have to move the window). Instead, we'll draw the axes' 
divisions right away. Put the crosshairs on the upper end of the axis and 
draw a 10-pixel-long dash to the left. We'll mark this position with 50% 
later. 

Now we can mark the position on the chart where 40% is located. It should 
be 40 pixels below the top division marker. Since we don't want to have to 
count out 40 pixels, we'll set the coordinate pointer in the status line. We set 
the cross on the top point of the axis and click. These coordinates are set to 
zero and we can move to exactly the right spot on the axis. Once you've 
found it, click there and set these coordinates to 0. 
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Now click again to draw a line to the left (10 pixels in length). The division 
marker for the 40% is now finished. Now we want to label the axis in the 
visible area. Click T and choose the BSW 9 Point and bold items. Now 
write in the percentages. The visible part of the geoPaint window is now 
finished. 




Figure 41: Starting the vertical axis 



Now we need to move the window down so that we can draw the rest of the 
vertical axis. Click the scroll box, and move the window as far down as you 
can while still being able to see the 40% division marker. 

Now draw the rest of the axis with the division marks. If s quickest and 
easiest if you draw a 40-pixel line down and then a 10-pixel line to the left. 
Eventually you'll need to move the window a bit further down to enter the 
zero point Once this is done, we can start on the horizontal axis. 

We need to divide the line into sections of lengths 50, 20, 50, 20, etc. We 
can use these marks to draw the individual bars later. 
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Our chart should look something like this now: 




Figure 42: Zeropoint and horizontal axis with divisions 



Move the geoPaint window far enough to the right so that you can draw the 
whole axis. 

When youVe finished, it might be a good idea to write the descriptions right 
away. Since youVe marked in 50-pixel-long sections, you can easily see 
where they go. The window is already all the way on the right, you can 
label the sections from right to left. Write Housing for the last section, 
then Personal, Misc, Car, and Food. For the last three, youll need to 
scroll far enough back so that you can see the zero point 

Now we can draw the bars. We need to calculate the percentages in pixels. 
That's very easy: 10% = 40 pixels 

The first colunrn for food must be 60 pixels tall. If s best to click the line 
icon and set the crosshairs exactly on the zero point (0%). If you click here, 
move 60 pixels up the axis and you have the correct height for the bar. 
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If you keep the crosshairs on the axis, you can find exactly the correct 
coordinates. Double-click to set the coordinates displayed in the status box 
to zero again and move 50 pixels to the right (width of tiie bar). Then draw 
a line from there to the horizontal axis. 

Now lef s add a third dimension to the bars. We can do this as follows: 

Set the crosshairs on the upper left comer of the bar. Now draw a line 20 
pixels to the right and 10 points up. Click and then draw a line 50 pixels 
long toward the right side of the screen. Now draw another 20 pixels to tiie 
left and 10 down. YouVe finished the top of the bar. 

It should look like this: 




Figure 43: Two sides of a bar 



If you draw a vertical line from the right rear comer of the bar to the 
horizontal axis, the figure is finished* 
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Now repeat this for the other bars. Once youVe finished, the bar chart is 
almost done. You can improve the appearance even more by using the fill 
patterns. Click the current pattem icon to display the pattern options in the 
status box. Then choose the desired pattem by pointing to it and clicking. 
The new pattem appears in the current pattem icon. Now click the faucet 
icon, place the crosshairs inside the bar to be filled, and click. 

Our chart looks like this: 




Figure 44: Section of the finished bar chart 



Since the graph is bigger than the window, if s useful to look at the whole 
figure at the same time. Choose preview from the file menu. The page 
is reduced and displayed. Now you can see how the chart appears on the 
entire page. The fuU page in our example looked like this: 
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Figure 45: Bar chart in preview mode 



4.1.3 Line graph 



A line graph isn't a very good representation of our Expenses data. 
They're best when you want to display data with a time factor — for 
example, expenditures over a year. But well graph it anyway so you can 
compare the various kinds of diagrams. 

First we need two axes. To make it easy to compare a bar chart and a line 
graph, well divide the axes in the same way as we did for the bar charts. 
Each 10% division should be represented with 40 pixels. If you have 
trouble doing this, refer to the previous section where we describe the steps 
required. 

After youVe drawn the axes, draw the lines for the chart. Start with the line 
icon at the zero point and draw a line 50 pixels to the right and 80 up (20%). 
Then draw a line 50 pixels to the right and 40 down (10%), etc... We 
changed the labeling of the lower axis to make the diagram more readable. 
To let you compare the two kinds of charts more easily, here is a section of 
our line graph: 
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Figure 46: Line graph 

We hope that these examples help you produce charts and graphs more 
easily- Using these three types of diagrams, you can graphically represent 
most kinds of data. 
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4.2 Organizing and planning with geoPaint 

You need the following for this section: 

A geoPaint work diskette with at least 30K of available space. You can 
erase GEOS, GEOS BOOT, GEOS KERNAL, geoWrite, TEXT 
MANAGER, and all the printer drivers that you don't require. 

When drawing objects, you may find that you need to insert identical 
objects several times. You may need to rearrange the objects to get tiiem the 
way you want them. Using geoPaint you can add and arrange objects until 
youVe got the form and positioning of the objects exactly the way you like 
it. Well look at these capabilities with two examples. You'll see ways to 
make your work easier by using GEOPAINT's capabilities fully. 



4.2.1 Room layout 



Our first example is planning the layout of a room. This is a good example 
for geoPaint, since youll probably move the fumiture around while 
rearranging one of your rooms. We made this example fit in the geoPaint 
window to make it easier— you won't have to spend time scrolling. In this 
way, you can see the whole picture at once. To simplify our example, we 
used metric measurements since the dimensions are easily divided by 10. 



Object 


Lmgth 


Width 


Room 


6.0 m 


3.0 m 


Bed 


2.0 m 


1.0 m 


Cupboard 


2.0 m 


0.5 m 


Table 


1.0 m 


1,0 m 


Arm chair (2) 


0.5 m 


0.5 m 


Shelf 


1.8 m 


0.3 m 


Desk 


1.4 m 


0.7 m 


Chair 


0.4 m 


0.4 m 


Table lamp 


25 cm 


25 cm 
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Let's start drawing the room. Load geoPaint. Let* s call the document My 
Room. 

Since we want to see the whole room in the geoPaint window, we'll use the 
scale of 1.0m = 40 pixels. Since just describing how to draw the figure is 
kind of dry and hard to follow, we documented it with pictures. The first 
picture shows you what the first several paragraphs describe. This should 
make it easier to follow the description. 




Figure 47: Walls and dimensions 



The line tool is perfect for drawing the walls. Draw two horizontal lines 240 
pixels in length and two vertical lines 120 pixels in length. Leave some 
room to write dimensions around the figure. Next mark the window. The 
top window begins 60 pixels (L5m) from the left and is 80 pixels wide. To 
mark its position, draw two lines that are five pixels long. Unfortunately 
you can't use the ruler to measure the distance. Technically, you can 
measure the distance, but you can't mark the end point so that you can draw 
the lines with the pencil tool. 

But you can use the trick from the previous chapter. Draw a new line on the 
wall that's already there. Then you can easily find how far 60 pixels is and 
then draw a vertical line from that point right away. 
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The right window is 44 pixels (1.1m) from the top. It is 60 pixels wide. 
The door starts 32 pixels (0.8 m) from the bottom. Set the line there and 
draw a line 16 pixels right (0.4 m) and 28 pixels up (0.7 m). To show the 
arc for the door, use the following trick: 

It's difficult to draw a curved line correctly, so click the circle tool and 
choose the door hinge as the center point. Move the circle until it touches the 
upper comer of the door. After this, erase most of the circle with the eraser 
tool, and remove the rest in pixel edit mode. Now we have a good 
curved line. 

It is easy to label the upper and lower walls. We used University 6 
point type. To write on the left to right walls, enter the length in the 
middle of the room, surround it with with the cut marker, and then use 
rotate to rotate the first label once. Use rotate to rotate the other label 
three times. Then you can move the labels to their correct positions. Make 
the border for the edit box as small as possible so that you won't erase part 
of the wall when you copy. 

Now we can draw the first object and put it in an arbitrary location in the 
room. Well start with the bed since it*s pretty big and can't fit just 
anywhere (you dQ need to open the door!). Draw a rectangle 80 pixels x 40 
pixels (2.0m x 1.0m) in the middle of the room. Label it Bed. Well put it 
next to the window. This example shows how easy it is to move objects 
around the room. Well show you the result of this in the following picture 
before we describe the moving process: 
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Figure 48: The bed 



First rotate the bed 90 degrees. Select the edit box icon and enclose the bed. 
Then click rotate in the status box. Next click copy in the status box. 
Now position the cross-hair on the bed and move it to the window, copy 
and click the lower right comer of the bed. Move the lower right comer of 
the room. The lower comer of the bed is deposited where the crosshairs is 
positioned. Using this tip, you can put the object exactly where you want it. 
Leave a little space between the bed and the right wall so that the window 
border doesn't disappear. 

We didn't move the bed. Instead, we used copy to put it in the correct 
position so that we could show the bed rotated and unrotated in our 
illustration. We got rid of the extra bed in the middle by clearing the 
selected area. 

Now we can draw and position the rest of the fumiture. Here is the right 
half of the room once this is completed: 
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Figure 49: Right half of the bedroom 



It is easiest to create the objects in the same way you made the bed. Draw 
the object in the middle of the room, rotate it if necessary, then move it to 
the correct location. Since the seats are so small, we labeled them with S in 
BSW 9 point type. 
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Here*s how the rcx)m looks fully furnished: 




Figure 50: Fully furnished room 



We can draw the lamp L with the circle tool. We can draw the table T in the 
upper left comer. Since geoPaint rotates items only in 90 degree increments 
and this table is rotated 45 degrees, we must draw it with the line tool. We 
labeled it with the T in pixe 1 edit mode using individual points. 

Now we're finished laying out the room. Maybe you'd like to to try moving 
the furniture around the room. Here's a little tip: 

Since the room doesn't have enough free space to move the large objects 
freely, you can use some edit functions. For example, to exchange the 
position of the bed and the desk, enclose the desk and chair with the edit 
box and use cut to put the section in photo scrap. Then move the bed 
to its new place under the window and rotate it three times to get it 
positioned correctly. Then move all the chairs far enough to the left so that 
you have room for the desk. Position it with paste and rotate it to an 
appropriate place. Then you can move the chairs to the right again. If there's 
not enough room to rotate, you can move the geoPaint window to display 
and unused area, put the object there with paste, rotate it there, and then 
use cut again to put it in photo scrap. 



105 



Abacus Software 



GEOS Inside and Out 



4.2.2 Laying out a garden 



We made the drawing fit in the geoPaint window when we did the room 
layout. However, if we want to lay out an entire house with geoPaint, we 
will need the whole page. We thought it would be a good idea to go through 
a different example of how to do this. Try to plan and lay out a garden using 
geoPaint. In attempting this we discovered: 

• you can draw an attractive garden using geoPaint, and 

• we're not particularly good at drawing gardens. 

While we weren't completely satisfied with the results of our artistic 
endeavors, we think that using the tricks we have learned, you will meet 
with greater success. 

We designed a 8.0m x 8.6m garden and used a scale of 1.0m = 50 pixels. 
We named the document My Garden. 

First draw a border around the garden. The upper line is 430 pixels long. 
Don't start in the upper left comer. Start about an inch down and to the right 
of that comer so you'll have room to write labels and title the drawing. We 
drew a dash every 100 pixels and labeled them so that we could orient 
ourselves in the drawing more easily. 

To draw this line you'll need to move the geoPaint window twice with the 
scroll box. You can save a lot of time if you move the window as little as 
possible. When you've finished the line to the right, it's best to draw the 
400 pixel long vertical line immediately. 

After the border is finished, start with the terrace in the lower right comer. 
It's 130 pixels wide and 1(X) pixels long. The three steps on both sides of 
the terrace are 50, 40, and 30 pixels wide and 10 pixels long. Indent each 
higher step 5 pixels from where the preceding step starts on both sides. We 
then can fill the steps with a pattern. 

The steps lead to a path that is 20 pixels wide. An oval representing a small 
pond is in the middle of the area surrounded by the path. Since geoPaint can 
draw circles, but not ellipses, we had to use a trick to draw it. 
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First mark the center, and then draw a circle. Draw a vertical line through 
the center. Then use the edit box to move the left half of the circle about 10 
pixels to the left, and the right half 10 pixels to the right Then connect the 
tops and bottoms of the two half-circles and erase the vertical line. Now the 
oval for the pond is finished. 

The preview option can help you in laying out the garden. We used it a 
lot. It allows you to see how the size and positioning of tiiie individual items 
in the garden look. 

Here is what our garden looked like: 

, I I , 




We're sure you have more landscaping potential than we do. . . 
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4.3 Electronic circuits 



You need the following for this section: 

A geoPaint work diskette with at least 35K of free space. You can place the 
folwing files in the waste basket: GEOS, GEOS BOOT, GEOS kernal, 
geoWr ite, TEXT MANAGER, and all printer drivers that you don*t need. 

If you looked inside your C-64, you'd see the thin composite board that 
holds and connects the different components and computer chips. It is 
actually a large printed circuit board. PC boards are used in the design and 
production of virtually every electronic device. There are programs available 
for laying out circuits and designing printed circuit boards with the *64. 

Well show you how to you can perform this intricate work using geoPaint. 
We were surprised how easy it is to draw electronic circuits and how 
professional the results looked (in contrast to our work with the garden!). 
First well work with an example that fits in the geoPaint window: a 
PC board. 



4.3.1 PC Board 



Load geoPaint and enter PCBoard as the name of the document. We'll 
show the results first so that you can follow the individual steps more 
easily: 
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Figure 52: PC Board 



First draw the border of the PC board quickly using the line tool. 

Next draw a pattern for an integrated circuit (IC) in the middle of the PC 
board. It's easy to do if you use the line tool in pixe 1 edit mode. The 
IC is 42 pixels long and 21 pixels wide. This is what an IC looks like under 
the magnifying glass: 
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Figure 53: An IC in pixel edit mode 



Draw the IC's connection pins now (but not the label, since it varies for 
different ICs)* When you're finished, click the edit box and enclose the IC. 
Put it in photo scrap using the copy option. Now label the IC in the 
geoPaint window with SA J 130 NTZ 423 9K. Choose University / 
6 point type from the fonts menu. 

Now rotate the IC by 90 degrees, and then move it to the upper left 
comer of the PC board. Use copy to make a duplicate of it in the lower left 
comer. You can duplicate the other ICs in the same way. Copy the IC 
pattern from photo scrap with the paste command. Label it LH 119 
K 4 9 6L K. Then move it with move to the empty area in the upper left 
comer. Position the rest of the ICs using the copy command. 

Now you can draw the power connection on the right side of the board. 
You can easily do this using the pixel edit mode. Now the PC board is 
finished. If you want to use the IC for future designs, load photo 
manager and put it in a photo album. In this way, you can gradually 
develop a collection of components in a photo a Ibum. You can then use 
these components to design other PC boards. 
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4.3.2 Schematics 



Here's another example of how you can use geoPaint The following is a 
schematic that is often found in introductory electronic books: a 
multivibrator with relays. 

We won't look at the technical side of this problem (i.e., we're not going to 
draw a circuit that will really work) — ^we're just going to show how easy it 
is to draw a schematic with geoPaint. Most circuits of this type contain just 
a few types of components (resistors, diodes, transistors, etc.)- To design 
more powerful circuits, create a special photo album exclusively for 
these components. Then just paste the required component in the circuit and 
connect them with wiring as they're needed. 

Another small trick that can save you a lot of work is creating another 
character set. Almost every technical field has special symbols that it uses. 
geoPaint doesn't have these special character symbols-we need omega (Q) 
and mu for our circuit. 

While you can't alter geoPaint's character set, there is a trick you can use. 

After manually drawing a special character, copy it into photo scrap, 
and then put it in the photo album. If you need another special character, 
paste the album's special character page in an area of the screen not being 
used, draw the new special character in the area pasted in, copy it to the 
desired area, and paste the expanded special character page back in the 
photo album. In this way, you can quickly build up a set of all the 
characters you need for these sorts of applications. 

Before we start to describe how to draw the circuit, we'll show you the 
results so you can get an overview of what weVe going to do: 
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Figure 54: Multivibrator schematic 



We'll start in the upper left comer. First draw the part of the power supply 
wiring (+9V) that fits in the geoPaint window. Then start with the 
connection line to the resistor Rl. The resistors are 10 pixels wide and 30 
pixels long. We wrote the Rl 820 label with BSW 9 point type. The 
character "fli" for ohm is the first special character that well need. Draw it 
using pixel edit. Here's how it looks in that mode: 
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Figure 55: Ohm symbol (Omega) 

Leave pixel edit mode. Enclose it with the edit box and copy it into 
photo scrap, since we'll need it several times. Now we can draw the 
top connection. We can easily draw it with the filled circle tool and the filled 
surface as tihe pattern in the pattern table: 
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We can draw the capacitor in pixel edit mcxle and also paste it in the 
photo album. We can also draw the special character mu this way. 

We saved a little work by entering 1500 |IF in BSW 9 point. We just 
had to add a couple points to the |i to finish the special character: 
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Figure 57: M\l 



The transistor Tl is placed beneath the capacitor. Move the geoPaint 
window with the scroll box as far down as you can and still see the 
capacitor. Then you can draw the wiring between the components. Here's a 
printout of this section: 
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Figure 58: Capacitor and transistor 



Draw a straight line from the capacitor to the transistor that goes as far right 
as the T 1 - R3 connection point. This saves us a lot of work later. 

Draw the circle for the transistor symbol with the circle tool. It's easiest to 
use pixel edit to draw the lines for the emitter, base, and collector of 
the transistor. Then draw the power supply in the far left section of the 
screen. Remember, youll save time if you use scroll box as seldom as 
possible. 

Next draw resistor R3. If you copy it to the photo album, you can paste 
it in this document and move it to its proper location. To do this, load the 
photo manager. You can paste the special characters Q and MM.in the 
album now also, if you haven't already done so. The potentiometer P 1 
located below Rl is easy to make. Copy Rl (which akeady has the small 
circle below) to the area below it When you need to place something in the 
document, check to see if you can copy part of it from another area (using 
mirrors or rotations). For this circuit we drew only a few components. The 
rest we drew by copying sections of the page. 
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Finally, complete the wiring to transistor Tl (thafs the line with the small 
dash) and the two connections from P 1 to the line below. 

You may want to draw transistor T2 first so that you can find where the 
second group of components should go. Use flie scroll box to move up until 
Tl and CI are in the geoPaint window. Now enclose both with the edit 
box: 




Figure 59: Copying transistors 



move the enclosed area as far as possible to right. Then reflect it about the 
Y-axis with mirror X, and youVe finished the second transistor with 
capacitor. If necessary, move the geoPaint window a little to the right and 
then move the transistor too. Youll need to mark it again after using the 
scroll box. Mark the connection point between the capacitor and the wiring 
with a black connection point, drawn using the circle tool. 

Next well make resistor R2 and capacitor C2. Copy Rl (without the 
description) in such a way that it's located relative to transistor T2. Copy 
the description on the resistor's left side later. 
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You won't need to draw resistor R4 and potentiometer P2. Enclose R3 and 
P 1 with the edit box. Then copy the section to the right and reflect it using 
the mirror X command. Then move it so that the connections from R4 
and T2 fit. Now just erase the description and type a new one (you can 
copy the ohm character (Q) from R3). Now the left half of the circuit is 
finished: 




Figure 60: Mirroring potentiometers 



You can create R5 by rotating another resistor 90 degrees. Transistor T3 
is made by copying T2 and then changing the title. The component group 
above T3 consists of a diode (D) and a relay. We created the diode in 
pixel edit mode. It is located 5 points from the comer. 

Then we drew the rest of the wiring and labeled the power supply. The dash 
- and the text +9V 20.. 60 |XA are written in BSW 9 point outline 
type. We clicked bo Id for the title Multivibrator with relay. 
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Here's the way the reduced picture looks using preview: 




Figure 61: preview of the schematic 



Looking at the descriptions, it is easy to recognize the components* The 
preview option is very good for orienting yourself to the picture and 
seeing if your layout is correct, especially when you create documents that 
are larger than the geoPaint window. 

We hope that you paste so many components and special characters in the 
component album that youll soon have a complete collection of finished 
components. 
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4.4 GEOS and educational applications 



Teachers and students alike are constantly required to produce illustrations, 
drawings, forms, tables, and other kinds of documents. 

We'd like to give you a couple of examples of how GEOS can help teachers 
and students save time and produce higher-quality documents. We want to 
look at both the advantages of GEOS as a graphic tool — such as its easy 
editing, and its diverse range of labeling possibilities. 

We'll also look at its disadvantages. While working with geoPaint, we tried 
to produce some figures that are just about impossible with this program. 
Freehand drawings are very difficult to do with geoPaint. It's best if the 
documents you create are almost entirely composed of geometric objects that 
geoPaint offers (i.e. circles, rectangles, and lines). For example, you can 
make ellipses by drawing a circle and then moveing the two halves of tiie 
circle away from each other. 

Youll learn to recognize what can and cannot be quickly and easily drawn 
with the geoPaint program. Now let's look at a few educational 
applications. 



4.4.1 Diagrams in reports 



Some illustrations can't be drawn with other '64 graphics programs, 
because the labeling techniques needed just aren't available. But these labels 
can be easily created with geoPaint. This first example is a diagram for your 
History 101 class: the economic structure of Russia in 1913. We'll just 
show you the final result-since our descriptions earlier in this chapter 
should suffice-and let you work on your own. 

It didn't take us much time to draw it, and the diagram can be used for 
various projects. You could use it in a book report one year, and then as 
part of a class paper the next semester (as long as you get different 
teachers. . .). We like to think of this as "scholastic multi-tasking". 
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'A^ss Strucuue- — Russia. 1913 

Nobles fr Clef^ip:!^ 



Uppef: 2.99£ 




Middle Class: lA.'K!: 
Norkers: 2% 




««ififii fcfnitfff 



Measuie units: □ inches 
X: £8 V: 17 distance 



pixels 
36 



Figure 62: Russian economic stracture-1913 



4.4.2 Teacher^s forms 



Every teacher needs to design forms like course outlines, project sheets and 
assignments to explain and organize material. If you do this with paper and 
pencil, you quickly end up with a full trash can, because you're bound to 
divide the page up incorrectly, or discover that one element doesn't fit in the 
space provided, etc. Also, if youVe been teaching any length of time, 
youVe probably already got a stack of old documents for every occasion. 
All you need to do is copy the format of a few good examples, then fill in 
new information as needed. 

geoPaint is terrific for this kind of application, since it has almost everything 
you need — circles, lines, rectangles, and many different text styles, fonts, 
and p<)int sizes. You can even use your forms on an overhead projector. 
You just print out the document, and then copy it onto a clear sheet of 
acetate — voila! 
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4.43 Seating Charts 



You might need to make seating charts at the beginning of the year or 
semester. Not only can you do this using geoPaint, it also offers the 
following advantages: 

• Since seating charts change only when new students arrive or 
you decide to alter the arrangement of the desks, you simply 
modify the existing seating chart that youVe stored on diskette. 
You don't need to redraw it from scratch. 

• Usually the number and placement of desks is almost identical 
from room to room. You can make a master that other teachers 
can use for their class rooms. Then they just need to enter the 
students* names. 



4A4 Science class diagrams 



If youYe a science teacher, your students must often perform experiments 
and usually need a method to chart the data. It would be nice to be able to 
produce diagrams quickly, accurately and easily. It's easy to produce 
scientific charts with the geoPaint program. You can draw a format page 
with a rectangle divided into sections and have the students plot and label as 
required. 

We have one tip. You may find that you want to make minor modifications 
to and existing drawing to save some work. But be careful — don't put both 
the original and the copy on the same diskette. Because they will be so 
similar, you could lose the original. 
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GEOS Tips and Tricks 



Each time we used GEOS, we were always amazed by its capabilities, as 
well as by the flexibility of its programming. In this chapter we're going to 
present you with some of these possibilities, and reduce tfie time youll need 
to take to get up to "full speed" with GEOS. 

Because this book was written in Germany and will be sold intemationally, 
we've included a section on adjusting the GEOS operating system to operate 
at the European electrical standard of 50 Hz (the American standard is 
60 Hz). Because of this modification, certain programs may not be 
compatible. However, every program in this book or on the optional 
diskette is compatible with GEOS both in 60 Hz operation and modified for 
50 Hz operation. 



5.1 Tips and Tricks for the GEOS user interface 



This first section gives you the benefits of our experience with the user 
interface and the different programs that compose it. In the second section 
we will expand and improve upon what we discussed in the first section. 
We believe that this will make GEOS both easier to use and more powerful. 



5.1.1 Problems loading GEOS 



Youll probably have problems using GEOS before you use the joystick or 
try to start your first application. This first section deals with the problems 
you might have loading GEOS. 

There are two reasons why GEOS has trouble booting. First, GEOS has a 
very sophisticated copy protection scheme. If the distribution diskette is 
copied, the new version will be unable to run because GEOS will not find 
some important copy protection information. However, occasionally GEOS 
can't find this information even if you are using the original copy of the 
program. 
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There are also problems associated with the fact that GEOS uses fast disk 
access routines. For one, if you have your printer powered up while you 
boot GEOS, it may or may not load. 

If GEOS does not boot properly, there is no reason to worry. Just restart or 
reset the computer after an unsuccessful load. 

If the BOOTING GEOS message disappears from the screen before the 
GEOS is finished loading, tum the computer and disk drive off and then 
back on again. 

If nothing happens, even after a few tries, there is still hope. Read the 
following troubleshooting list and answer accordingly: 

• Did you try to boot with the original diskette? This is the only 
diskette that GEOS can boot. 

• Do you have only one disk drive (with device address 8) tumed 
on? Normally the disk drive has the device number 8. 

• Did you tum your printer power off? Sometimes GEOS does 
not like having a printer on during booting. GEOS will display 
the printer and waste basket icons, but will then wait until the 
printer is tumed off. 

If all these points have been addressed, but you are still having problems 
booting GEOS, there is still a trick that will take care of most problems. 

GEOS is very finicky with disk drives that are poorly adjusted. If s possible 
that GEOS won't find the copy protection if the read/write head is out of 
alignment. There are two ways to take care of this problem. 

Note: If your disk drive has mechanical problems, neither of the following 
procedures will work — ^you will have to take your disk drive to a dealer for 
readjustment 

Don't use either of these techniques with disk drives that are very warm, 
because the procedures can cause the mechanical operation of the read/write 
head to malfunction. If your drive is running very warm, we suggest that 
you tum it off for 15 minutes or so and read a few more pages in this book. 
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1) Get a blank diskette, or a diskette containing material you don't 
need any longer. Format this diskette. This will automatically 
realign the read/write head (as long as there are no mechanics^ 
problems). 

If you don't know how to format a diskette, type the following 
on the screen in the C-64 direct mode and then press 
<RETURN>. You can replace NAME with any name up to 15 
characters, and ID with any two-character or two-digit 
combination: 

OPEN 3, 8, 15, "N:NAME, ID" :CL0SE3 

After you have done this, you will hear a whirring sound. After 
about one and a half minutes the status light on the disk drive 
will go out. Now try booting the GEOS diskette again. 

2) If you don't have any spare diskettes or you are looking for a 
simpler method, type in the following program: 

10 REM This program moves the disk head 
20 REM into post ion 

30 OPEN 3, 8, 15, "I": Open disk channel 
40 REM Initialize 

50 PRINT#3, "M-W"CHR$ (0) CHR$ (0) CHR$ (192) 
60 CL0SE3 

The REM lines are there for explanation only; you may remove 
them if you wish. Start the program by typing RUN, you will 
then hear the whirring. Afterwards, the read/write head is 
realigned and ready to use. 

If none of these work, try another original diskette before running out to 
your dealer for disk <Mve repair. Try to borrow a copy of GEOS from a 
friend, or ask your dealer — this shouldn't be any problem. If it tums out 
that there is something wrong with the original diskette, ask your 
Commodore dealer to find out what to do next. 

Just remember-do not format or use diskettes in a very warm disk drive. 
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5.1.2 deskTop "Do's and Don'ts^ 



When youVe working with GEOS, always follow these guidelines: 

Never change the diskettes without first using open . That means that you 
can't change diskettes unless you are working in deskTop, since the open 
command is available only from the file menu. There are safeguards in 
GEOS to protect you from quitting a program without the diskette 
containing tfie active program being in the drive. 

Even with these safeguards, exchanging geoPaint with the scroll box while 
the geoPaint window is still active will produce some interesting screen 
effects — not to mention a system crash. 

Never open the drive door when you save or load GEOS. This also means 
you should never take the diskette out of the drive when saving or loading 
GEOS. 



Never turn off the disk drive power when GEOS is running. The swap file 
GEOS uses to store disk input/output will be lost. 

Always use different names for each diskette. GEOS cannot distinguish 
between different diskettes with the same name. Using identical disk names 
makes copying and saving files very difficult 

Use only the original GEOS diskette for booting. Once you are finished 
booting the system, put it in a safe place. If you happen to lose one of the 
first four programs necessary for loading GEOS, you have two options for 
restoring tiie original diskette: 

1) If you are still in GEOS and you notice that one of the 
programs is missing, you can copy the missing files from your 
backup copy of GEOS back to tiie original diskette (assuming 
you made a backup of your original). You should then be able 
to boot up using the original diskette. 

2) Load the BACKUP program from the backup copy of GEOS 
using: 



LOAD "BACKUP", 8 



128 



Abacus Software 



GEOS Inside and Out 



Start the program by entering RUN. Use the ori ginal copy of 
GEOS as the destination diskette of the backup. The copy 
protection will remain intact, even during formatting. 

Use your GEOS diskettes only with GEOS. Never use the DOS commands 
VALIDATE and SCRATCH with these diskettes. If you do this accidentally, 
load GEOS immediately and use the GEOS validate command under 
disk. Hopefully, GEOS can correct what was done to the diskette. 



5.1.1.1 GEOS file management and printing 



deskTop allows many different file management options. Take advantage of 
its flexibility. 

One of those options is the order in which the files are stored on the 
diskette. Lefs say that you have a diskette tiiat you usually use for storing 
geoPaint documents. You can you can move the documents to the first page 
of the directory. Now you can double-click this page and go directly to your 
document, rather than having to search through all of the pages of files. 

Second, use the info box. This allows you to maintain a very ordered and 
efficient file system: 

a) Load the correct time and date with the Preference Manager 
immediately after booting GEOS. This is useful when you 
store different versions of a graphic or text document. When 
you list the files, you can use the date and time to determine 
which file is the most current, and which is the original. 

b) Using the help screen, you can store important information 
about each program. This information could include: 

• Information about what the program actually does 

• The version of the program 

• The starting address for this program 

(for programs written in machine language) 

For instance, you can store your video games' POKE address 
where you can increase the number of "lives" you get for a 
game. Or you can store answers to riddles to spark your 
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memory when you play adventure games. Before you can do 
this, tiie game must be changed to the GEOS format, so you 
can access the info screen. Use the FILEMASTER program 
discussed later in this chapter. 

GEOS lets you print graphic or text documents directly from the deskTop or 
from an applications program. You can install the printer file only from 
deskTop. There were many times when we wanted to print a graphic 
document from an application — only to realize that we never initialized the 
printer from the deskTop. Therefore, you have to leave the application, 
return to deskTop, initialize the printer and then retum to the application. 

WeVe learned from experience that it is better to print graphic and text 
documents while running the respective application. At least we found this 
to be the case with our printer (an FX-85 with interface). It is impossible to 
retum to deskTop if the printer is still turned on. GEOS will still display the 
printer and waste basket icons — ^but GEOS will wait until the printer is 
turned off to continue. This also occurs after using deskTop to print. We 
decided not to print from deskTop unless it was absolutely necessary. 

During printing, a window displaying Printing . . . CANCEL appears. 
If you click CANCEL, you can halt the printing. The joystick cursor appears 
over the CANCEL button. However, you might not be able to see it for a 
short while. We suggest that you hold the fire button down until the 
window disappears. GEOS registers this after a few seconds. 

To print a file from deskTop, make sure that the desired document is on the 
same diskette as the application. For instance, to print a letter, the letter must 
be on the same diskette as geoWrite. 

One last comment about printing. Whenever printing from an application, 
GEOS displays the error message: 

PLEASE INSERT A DISK CONTAINING THE DESKTOP 

...even though deskTop is akeady on the diskette in the drive. After the 
printer is finished, click OK to retum to normal. 

Occasionally GEOS will not want to print text or graphics. It will only print 
blank Unes. If this happens, we can offer a tip (not a fix) for the problem: 

Copy the document to another GEOS diskette. You can now try to print the 
file using this deskTop, or just use BACKUP to make a new working copy. 
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If you have a lot of files to copy, GEOS has a feature to make life a little 
easier: duplicate. First enter the filename patterns, and then use 
duplicate to make as many copies as you want. 

You will have to give a different name for each copy you make. You can 
simply change a few characters for each name, or add a number to the end 
of the name to show the version or copy number. If you make three copies 
of a file (let's say for Meyer, Miller, and Tyrone) you could name the files 

MEY, MIL and TYR. 



5.13 Tips and Tricks for geoPaint 



geoPaint is a great program for creating graphic documents. The more you 
use this program, the more ways youll find to make the job easier, and to 
create special effects. In this section we're going to look at some of the 
interesting points of geoPaint. 



Graphic formafs and scaling 

The area with which geoPaint can work is actually larger than what you can 
see in the geoPaint window. From left to right there are 640 pixels, and 
from top to bottom there are 720 pixels. Altogether, this is about 460,800 
individual points. In comparison, the C-64 without GEOS had only 
320*200=64,000 pixels. How does this look on paper with the larger 
window size? This is very important when trying to visualize the final 
product 

The size of the image is dependent upon the printer. Here we present the 
results for the FX-85, which is the main printer we used with GEOS. 

If you have a different printer, you can draw a line 200 pixels from left to 
right, and another line 200 pixels from top to bottom. Now print this to 
your printer and measure it on the paper. The FX-85 can draw a maximum 
line width of 24 cm. This corresponds to 530 pixels in geoPaint. If you use 
the pixels from 530 to 640, these will not be printed on the paper. Since 
there is no easy way to determine where to stop drawing, it*s easier if you 
draw a boundary line. 
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To print the whole screen you will need an EPSON FX- 185 or compatible 
printer. 

The entire picture can be printed on a standard 8.5" x 1 1" sheet of paper in 
the vertical direction. The 720 pixels are printed in 25.4 cm. That means 
100 pixels are in 3.5 cm and 1 cm has 28.4 pixels. All of these dimensions 
are in the following table: 

Size and Dimensions 



Horizcmtal max: 
Printing width: 



Vertical max: 



640 pixels 




29 cm 


= 10.6 


530 pixels 




24 cm 


= 8.8 inches 


100 pixels 




4.2 cm 


= 1.66 inches 


1 cm 




24 pixels 




1 inch 




60.1 pixels 




720 pixels 




25.4 cm 


= 10 inches 


100 pixels 




3.5 cm 


= 1.39 inches 


1 cm 




28.3 pixels 




1 inch 




72 pixels 





The difference of 4.2 cm (horizontal) and 3.5 cm (vertical) for 100 pixels 
means that squares on the screen look like rectangles, and circles look like 
ellipses when printed on paper. If you use a different printer, this may 
change. 



Double-clicking tools 

You can activate every tool in the toolbox by simply clicking the icon. There 
are some tools tiiat have an additional function if you double-click the icon. 
For example, if you are using the pencil and you want to use the 
double-click feature of the eraser-erase the entire graphic visible in the 
window-all you have to do is click twice on the eraser icon. Here is a list of 
the tools that also have a second function: 
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Edit box: L:::! 
If this item is chosen, the entire geoPaint window is enclosed. However, if 
you only want part of the window to be saved in aphoto scrap, 
double-click the edit box icon and then choose the copy or cut items 
under the edit menu. 



Brush: 




Double-clicking this icon is the same as choosing the change brush item 
under the options menu. You can then choose from the 32 different 
brushes. 



Pencil: 




Double-clicking toggles between normal edit and pixel edit. 



Eraser: 




Double-clicking this icon erases the entire picture in the geoPaint window. 
If you are using pixel edit then only the visible portion is cleared. 

Brushes and Patterns 

You can do more with the fill pattems than just use them with the faucet or 
airbrush. You can use the brush tool to actually "paint" the pattems directly 
onto the screen. When you first run geoPaint, the pattem is a simple color. 
However, after you choose a different pattem, the paint brush uses this 
pattem until you switch again. You can create different special effects with 
different pattems and brushes. Try different widths of paint brushes with 
different pattems; youll be surprised what you can do. 

Pattems are used wherever you are working. Try using the airbrush with a 
different pattem and see what happens. You can use different pattems inside 
of others, as well as, using text. Here are the different combinations in the 
following hardcopy: 
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Figure 63: Using patterns 



Dotted Lines 

Perhaps youVe seen technical graphs using different dotted lines to 
distinguish between different events or topics. You can use a few tricks to 
make graphs that use dotted lines. 

The quickest and easiest way to get dotted lines is to draw a regular solid 
line and then use the spray can with the empty pattern (upper left of the 
pattem window) to spray empty spots over the solid line. This will erase 
parts of the line, resulting in a dotted line. While this is not the best method, 
it*s easy to use and will meet the needs of a lot of applications. 

You can make lines with a regular pattem by deciding which individual 
pixels should be turned on and which should be turned off. Using different 
patterns and pixel arrangements you can create many different patterns. We 
have tried different combinations of pixels, which we have listed below. If 
your application requires a regular pattem to your lines then these might be 
useful for making your graphs. 
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Figure 64: Dotted lines 101 



a) Normal straight line 

b) Same line with airbrush effect 

c) Brush 2.5 (2nd row, 5th from left) and pattern 1.3 
(row 1, 3rd from left). 

d) Brush 2.5 and pattern 1.5 

e) Brush 2.5 and pattern 1.7 

f) Brush 2.5 and pattern 1.14 

g) Brush 2.5 and pattern 2.1 
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Figure 65: Dotted lines 102 



a) Brush 2.7 and pattern 1.3 

b) Brush 2.7 and pattern 1.4 

c) Brush 2.7 and pattern 1.64 

d) Brush 2.7 and pattern 1.9 

e) Brush 2.7 and pattern 1.11 

f) Brush 2.7 and pattern 1.12 

g) Brush 2.7 and pattern 1.16 

h) Brush 2.7 and pattern 2.1 

What we're trying to show is that there are many different patterns 
available — experiment and find the best pattem for each application. Not 
every pattem looks good in every application. An example should show 
what we mean. 

Use brush 2.5 (smaller brush width) and pattem 2.2 (brick wall). The bmsh 
paints only a small portion of the pattem. The pattem painted depends on 
where in the wall you start painting. If you happen to start right on a line 
between bricks, you could end up with a solid line, or if you start in the 
middle of a row of bricks you could end up with a very sparse dotted line. 
We have drawn a document that shows what we are talking about. On the 
left we painted with a very wide bmsh using two different pattems. 
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Adjacent to each wide pattern area is the same pattern painted using a very 
thin brush, each starting in a different spot in the pattern: 




Figure 66: Dotted lines 103 (mixed with pattems) 



5.1.4 Tips and Tricks for geoWrite 



geoWrite is a WYSIWYG (what-you-see-is-what-you-get) word processor. 
This means that what you see on the screen will appear when the document 
is printed. If you underline a word, then it will appear underlined on the 
screen. This is much nicer than putting a control character before and after 
the portion you want underlined. 

Using this approach, geoWrite has a few limitations. For example, there is a 
short delay from the time you enter the text until it appears on the screen. 
But by using a few tricks you can get around many of these inconveniences. 

Enter some text using BSW 9 point or another font of a similar size. 
Let's say you later want to print out this text inDwinelle script. It's a 
good idea to enter the text in the same BSW 9 point. That's because you 
would only be able to see a few characters inDwinelle script in the 
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geoWrite window, since it's so large. After you have entered and corrected 
all of the text, then choose the format and style of your text We will 
demonstrate what we mean. First, we wrote a letter in BSW 9 point 
script. The lines that appear in the geoWrite window are too wide in 
Dwine 1 le to fit on a single sheet of standard paper: 

[ qeog I tile \ edit \ optiong j font \ § 1 fij!^ ^ ^^^^^^^ lo^fKiT^ ^^^^ . 



I quess it's time uje st»nited planninq our Macation foi* the summer. It's 
difficult at best to communicate ujith each other since you're in 
exams at the momient. I understand this, but time aujag is important, 
too. Therefore, I felt that I should drop ijjou a line regarding our 
summer vacation this gear. 

Portmerion, Wales, is out of the question. It's too expensive, and 
folks ujho haue spent time there tell me that because of its 
out-of-the-ujay locale, you sometimes feel like a prisoner. Other 
places such as Llanfair are too hard to say, and odds are none of 
the inhabitants of Llanfair speak English (and I knouj for a fact that 
your Welsh is incredibly rusty). 

I knouj houj much you loMe Paris, but frankly, I didn't enjoy it the 
last time uje ujere there, especially ujhen that man a»ith the qun «.uas 



If s easy to enter the text — however, you can't see the right margin. In this 
case, you must use the joystick to set the right margin of the paper. It will 
take two or three seconds before the screen shows this change. An easier 
method is to set the left margin to 1 and the right margin to 5. Youll find 
these numbers on the position bar. The edges are distinguished by an M on 
the left edge; the right side is barely visible. Click the fire button, then point 
the pointer to the spot you want and click again. This makes the letter easier 
to read, as shown in the following picture: 




Figure 67: Unformatted letter 
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[ qeos \ file \ edtt \ options \ font \ style i 1 | 



format 



ueai 



leaf Deb.. 

I guess it's time tue started planniri»3 our vacation for the 
summer. It's difficult at best to communicate ujith each other 
since youVe in exams at the moment. I understand this, but 
time wjQi4 is important., too. Therefore.. I felt that I should 
drop you a line regarding our summer vacation this year. 
Portmerion, Wales, is out of the question. It's too 
expensive, and folks ujho have spent time there tell me that 
because of its out~of-the-ujay locale, you sometimes feel 
like a prisoner. Other places such as Llanfair are too hard to 
say, and odds are none of the inhabitants of Llanfair speak 
English (and I knoiu for a fact that your Welsh is incredibly 
rusty). 

I know how much you love Paris, but frankly, I didn't enjoy 



Figure 68: Left and right margins 



By setting the margins, the letters will not only be easier to read, but you 
will also save a lot of time. 

When you have completely entered the text, you can choose the desired 
font. First, you will have to mark the block of text. To do this click the fire 
button on the first character of the block, then — ^keeping the fire button key 
or fire button pressed — ^move the joystick to the last character in the block. 
When you release the button, the block is marked, and appears in reverse 
video. Now, choose the font from the font menu, and choose the type 
style with style. 

This brings up a problem. You can mark only text that you can see in the 
marked window. Only the characters in the marked block of text are 
changed. The text above and below the window cannot be changed. This 
means that you have to move the window, but to do that you have to 
unmark the first block. 

The only possibility is to mark and change the text in sections. This is 
relatively easy to do (as long as you go from a larger font to a smaller font, 
the way we did in our example). If you change from a larger point size to a 
smaller point size, you are actually making more room on tfie single sheet of 
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paper. This pushes the extra text in the window down below the current 
geoWrite window. Youll then have to mark this text, which in turn pushes 
the other text down, and so forth until the entire file is reformatted. 
geoWrite automatically moves text to the next page. You can see this if you 
choose the next page option. 

Changing the text a portion at a time is slow and annoying. This is because 
the geoWrite window can display only a few words in, for example, the 
D wine lie font If you were to mark the block using BSW 9 point, the 
text would only take up two or three lines on the screen. The rest of the text, 
written in Dwinelle, stays below the window and out of sight. To get it 
from below the window to where it should be takes a lot of work. 
Therefore, it is better to start using a smaller point size and font and moving 
to a larger point size and font if required. 

If you have a large document, you can save yourself a lot of time and work 
during this reformatting stage. All you need to do is set the the left and right 
margins as close to the edges as possible. This allows geoWrite to change 
the maximum amount of text at one time. 

Next, you can alter the text to stand out from the rest of the document. To 
do this, simply mark the word or phrase and choose the appropriate style. 
For example: 
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I guess it's tirae we started planning our vacation 
for the surcifcier. It's difficult at best to 
communicate with each other since you're in exams 
at the rftoment. I understand ttds, but time away 
is important, too. Tlierefore, I felt that I should 
drop you a line regarding our summer vacation tios 
year. 

jPiurjiiemw. WdJes, is out of tl-ie. questitm. It's too 
expensive, and folks wtio Mve spent time there 
tell me that because of its out-of-ttie-way locale, 



Figure 69: Highlighting words 



Before you print the document reset the margins for the desired page width. 

You have a much greater degree of control over the design of your 
document using geoWrite, simply because what is on the screen is what is 
printed onto paper — ^true WYSIWYG display. If you want a few lines to 
start a few more columns to the right, simply enter a few spaces before 
typing to move the line over a littie. This brings up two new problems: 

The blank spaces may mean that the characters may not line up exactly. 
Each blank character moves the cursor to the right a certain number of 
pixels. The number of pixels is determined by the current font. Therefore, 
you can only move the cursor in a set number of positions. 

For example: You have ten spaces before each line, and each line starts in 
column two. Later, you change the text to a larger font. Now the blanks are 
also larger and the text now starts in colunm 3. Every time you change the 
size of tiie font, you must change the number of spaces to make the text nice 
and even again. 

There is an easier way. Use tabs to start a line at a different column. This 
way, if you change the size of the characters, the first character of each line 
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always starts in the same location. On the other hand, if you want to change 
all of the lines to start at a new column, all you need to do is change the tab 
position. To change the tab settings, just click on the column you want the 
tab. The cursor will move to the next tab location each time you press the 
<CONTROL>i key combination. 

Use the <RETURN> key sparingly. As a rule, you should only use the 
<RETURN> key when you reach tiie end of a paragraph. In other words, 
don't end each line with a <RETURN>. geoWrite automatically moves any 
word that doesn't fit on the current line to the next line. If you do press 
<RETURN> at the end of each line, you will run encounter problems when 
you try to format the text. Press <RETURN> only at the end of a 
paragraph. 

You can delete characters in the middle of the document simply by clicking 
the fire button to the right of the characters you want to delete, then using 
the <DEL> key. You can change individual characters, rather than just 
deleting them. Let's say you type the word letter, but you wanted to 
type Letter. Just put the cursor to the right of the 1, press the <DEL> 
key, and then type L. 

It is simpler to click on the 1, move the cursor to the right (keep the fire 
button depressed), and then release the fire button after the 1 is marked. 
Then all you have to do is type L. This sounds difficult, but once you try it 
a couple of times, it is really very easy. You can also use this method to 
change entire words or phrases, not just characters. 

Use the preview option of the file menu frequently. Whenever you 
change the margins or the fonts, your centered text, etc., will not look 
correct preview returns all the text to its proper perspective. This is a lot 
easier than continuing, and then having to come back to readjust all the text 
so that it looks "right". 

There are other tricks you can use to make the time you save even more 
significant. If you type a multi-page document, and later go back and add 
text to tiie first page, the extra lines of the first page are now moved to the 
second page, and the some of the text from that page are now on the third, 
and so on. If you want to break a page, even though the page isn't yet full, 
you can use page break. This option could be a real timesaver if you 
really want pages to end at specified points. 
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If you later decide that you want two pages separated by the page break 
to be put back together again, all you need to do is remove the page 
break's special character. To remove the page break, just place the cursor 
to the right of the special character and press the <DEL> key. geoWrite asks 
you to confirm — cUck OK: 




Figure 70: Delete page break? 



You can do the same thing with graphic document To get rid of the graphic 
document, simply place tilie cursor at the end of Ihe graphic document and 
press <DEL>. 

Some graphic document are as wide as the text. If you mark the document 
and then change the point size or use the tabs to get a column of smaller 
text, some of the document is cut off on both the screen and the printout. 

You can place a picture in the middle of text You don't have to worry about 
leaving enough space for the picture, before the text continues. geoWrite 
will take care of this for you by inserting the graphic document into the text 
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5.1.5 Tips and Tricks for Notepad 



Notepad is a collection of 127 note pages. You can use the Notepad from 
the deskTop or from any application. You can use the Notepad to write 
yourself notes at any time and look at them later. But you can do even more 
than this with the Notepad. 

You can use the Notepad as a daily calendar/reminder. Reserve a page for 
each day and enter your appointments on the appropriate page. Each day 
you can call up the page for diat day to review tiie appointments you have 
that day. A page in the notebook can look something like the example 
below: 




Figure 71: Notepad as daily calendar 



You can even use the appointment calendar as a way of checking to see 
what you did on any given day. If you left yourself notes about calling 
someone or doing something, you can refer back to the appropriate day and 
confirm that it was done. In most cases you might want to use the calendar 
for a single month. Page 1 is always the first to appear when you use 
Notepad. You have to click the folded comer of the Notepad to turn the 
page you want. If you have a lot of pages it gets very annoying to have to 
tum through a lot of pages to get to the current day. 
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If the notebook becomes full and you feel it*s time to start over, you can 
clear the Notes file on the work diskette. The next time you start up the 
Notepad you will have a clean notebook. 

The number of characters that can appear on a single page is dependent on 
two factors. On one hand, the maximum number of characters per page is 
254. On the other hand, you cannot start a line where the dogeared comer is 
located. If you use proportional text, then the number of characters you can 
fit on the page of the notebook will depend on the widths of the characters 
you use. Using narrow characters such as you would use all 254 
characters in about 2/3rds of the page; however, if you used all W*s, you 
couldn't fit 254 characters on a single page. 

You can use the Notepad to store information that you need to get at 
quickly. What we need is a notebook manager. You can keep addresses or 
telephone numbers in this convenient Notepad manager. Figure 72 has a 
sample of one way to keep an address book using Notepad: 




Figure 72: Using Notepad as an address book 
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You can keep other information you need in the notebook. The catch is, you 
can only have one notebook on each work diskette. You can get around this 
by keeping different data in notebooks on separate diskettes. An example 
would be to keep addresses and phone numbers in one notebook, recipes in 
another, and your car's fuel consumption records in yet another. Below we 
have another example of how to use the notebook for a recipe box. Bon 
Appetit! 




Figure 73: Notepad as a recipe file 



In this next section well discuss some programming concepts and how to 
use a diskette monitor, as well as some more tips to manage the notebook. 
If you want to leam more about the basic information, read the section about 
the VL IR file structure in Chapter 6. 

Normally, a file entry in the directory contains a pointer to the starting 
location of that program on diskette. The sectors that compose the file are 
then tied together by the first few bytes of each sector. If you were to look 
at the first sector and file entry for Notes, where the data should start, 
youll find a group of numbers instead. These numbers are the pointers to 
the track, sector format. Therefore, the first pointer is for the first page, the 
second is for the second page, and so on. 
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In other words, this sector contains pointers to each page in the notebook. 
What would happen if we used a diskette monitor to change the pointers? 
Later, when Notepad searches for a page, it will display a different page 
than it would normally. Therefore, you can manipulate Notepad with a 
BASIC program. Just read in each field of the file (B-R: and B-w 
conmiands). 

With a simple program you could: 

• Change the page numbering 

• Clear the first page 

• Qear the last page 

• Qear any page you want 

When you have changed the page you want, simply save the file and the 
notebook is changed. 

If you use your Notepad as an appointment calendar, and you don't like 
having to clear out everything at the end of every month, wouldn't it be 
easier to write a program that clears out the first twenty days and moves the 
remaining days to the front — ^i.e. keeping your calendar rotating? Also, this 
way the file will never get too large. 

It's not usually possible to print the contents of the notebook to a printer 
directly from GEOS. This is a definite disadvantage. However, it's possible 
to load the ASCII file directly from the Notes file on diskette to a reserved 
area in memory. From there you can send the file either to the screen or to a 
printer. Using what we learned above, you can print any page you want, or 
the entire Notepad. 

There's one thing you have to remember if you do want to print the contents 
of the Notepad. GEOS uses a form of security on the file. Therefore, when 
you read in the file, you will also have to do a few manipulations to print 
out the file in a legible form. 
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5.2 Programs in GEOS format 



If youVe worked with GEOS for a while, you have probably noticed that 
you couldn^t add your name as the programmer in the info box. Perhaps a 
friend of yours has copied one of yom* programs, but he can't tell it's one of 
yours. Or maybe you have an interesting idea for an icon that would be 
perfect for identifying a program youVe written, but you can mark only 
GEOS programs, and not standard C-64 files. If this is the case, then we 
have a solution to these problems. 

Working with GEOS, we have come across many different file format 
possibilities. We could just send you to Chapter 6, Inside GEOS, to read 
every detail about how the info box is handled under GEOS and how you 
can access it with a disk monitor. But maybe you don't have a disk monitor, 
or don't have the slightest idea of what to do with one. 

That is why we've done the work for you. The FILEMASTER program in 
this section quickly and easily transforms your standard C-64 files into 
GEOS format. 

Before we start, let's have a quick lesson in how a file is converted to the 
GEOS format. For a more detailed summary, refer to Chapter 6 and 
Abacus' Anatomy of the 1541 Disk Drive or 1571 Internals . 

Normally, the directory of a diskette has an entry for each file with the 
following information: 

1) File type 

2) Track and sector of the first data block 

3) Name of the file, ended by the character <SHIFT><SPACE> 
(ASCII $A0) 

4) Number of sectors in the file 

Each file entry has 30 bytes reserved for it. However, it does not use the 
full 30 bytes. The unused bytes are simply set to 0. GEOS uses these 
unused bytes for the following purposes: 

1) GEOS file type 

2) Track and sector of the info box 

3) Date and time 
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5.2.1 FILEMASTER 



To convert a file to GEOS format, you will have to free up a sector for the 
info box, and add the correct information to the file entry in the directory. 
Finally, the icon and the associated text must be entered and saved. 

FILEMASTER takes care of all of this for you. The icon has the same 
format as a sprite, which you may be familiar with from the C-64 
handbook. Therefore, FILEMASTER also has a built-in sprite generator. 

Before you go on to the FILEMASTER listing, we would like to mention 
the control codes in this program listing. When included in quotation marks 
as part of a BASIC PRINT statement, these control codes perform functions 
during program execution. These control codes are difficult to read at best 
when a BASIC listing is printed out on a Conunodore-type printer. We have 
listed FILEMASTER in a form that makes these control codes readable. 
Here are the codes and their meanings: 



[HOME] 




<CLR/HO]VIE> key 


[CLR] 




<SHIFT>ed <CLR/HOME> key 


[DOWN] 




<CRSRDOWN>key 


[RGHT] 




<CRSR RIGHT> key 


[UP] 




<SHIFT>ed <CRSR DOWN> key 


[LEFT] 




<SHIFr>ed <CRSR RIGHT> key 
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20 rem -filemaster man-fred tornsdor-f 
30 printchr*<14> 

40 -for i=0 to 7: read sp'A <i)snexti 

60 print' 'CCLRl" 

80 v=5324Sspokev+21,0 

100 print "CCLR3L RGHT 1 1 RGHT 1 C DOWN] C DOWND C DOWN 1 PI eas 

e insert diskette & press a key." 

120 geta*si-fa*=""thenl20 

140 opens, a, 15, "i " 

160 open3,S,3, "#0" 

180 prinfCCLRl" 

200 pr i n t " C DOWN 1 L RGHT 1 C RGHT 1 C RGHT 1 1 RGHT 3 C RGHT 1 C RGH 
TIL RGHT 3 C RGHT 3 C RGHT 3 C RGHT 3 C RGHT 3 C RGHT 3 C RGHT 3 C RGHT 3 
FILE-MASTER" 

220 pr i nt " C RGHT 3 C RGHT 3 C RGHT 3 C RGHT 3 CRGHT 3 C RGHT 3 E RGH 
T3 CRGHT3 CRGHT3 CRGHT3 CRGHT3 CRGHT3 CRGHT3 

II 

240 print"CDOWN3CRGHT3CRGHT3CRGHT3Convert Files in 
to GEOS format. " 
260 print "CD0WN3" 

280 pr i nt"CRGHT3 CRGHT 3 C RGHT 3Disk directory 
= dir" 

300 print "CRGHT3i:RGHT3CRGHT3Load sprite 
= spl" 

320 pr i nt " CRGHT 3 CRGHT 3!: RGHT 3Cr eat e sprite 
= csp" 

340 pr i nt "CD0WN3 CRGHT 3 CRGHT 3 C RGHT 3Read -file 
= rfl" 

380 print"CRGHT3CRGHT3CRGHT3Display -file info 
= -fdi" 

400 print"CRGHT3CRGHT3CRGHT3Create GEOS -file 
= geos" 

420 print"CRG,HT3CRGHT3CRGHT3Input/change date 
= date" 

440 print"CD0WN3CRGHT3CRGHT3CRGHT3Change diskettes 
= disk" 

460 print "CRGHT3CRGHT3CRGHT3End program 
= end" 

480 pr int" CRGHT 3 CRGHT 3 C RGHT 3Read in-fo 

= info" 
500 n *= " X >: x x x x x " 

520 input "CDOWN3CRGHT3CRGHT3CRGHT3Your choice" sn* 
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540 if n*="dir" then gosub 4060 
560 i-f n*="spl" then gosub 4060 
580 if n*="csp" then gosub 2320 
600 if n*="rfl" then gosub SOO 
620 if n*="date" then gosub 3160 

640 if n*="fdi" andzl=l then print " CCLR3 " :gosub 980 

660 if n*="info" then gosub 5100 

680 if n*="disk" then close3: closeS: goto 100 

700 if n*="end" then 760 

720 if n*="geos" then gosub 3540 

740 goto ISO 

760 close3:close5:pokev+21 jiOsstop 
780 stop :rem*«**«*»t 

800 z 1=0: gosub 1380 :if t=0 or zl=0 then return 

820 at=t: rem dir-track found 

840 as=s: rem dir sector found 

860 ab=bp:rem buffer pointer filetype 

880 tf =ts!sf =ss!rem track file, sector file 

900 fi*=na* ; 

920 gosub2220: fs=a: gosub 2220; gt=a: gosub2220: ja=a; j 
a*=str*(a) 

930 gosub2220: mo=a: fflo*=str* (a) 

940 gosub2220: ta=a:ta*=str* (a ): gosub 2220: ho=a:ho*= 
str*(a) 

950 gosub2220:mi=a:mi*=str* (a) 
960 gosub2220: 11 =a: gosub 2220: lh=a; 

980 print "CUP1CUPDCRGHT3CRGHT3CRGHT3CRGHTDCRGHT3CR 
GHT3 CRGHTD CRGHT3 CRGHTl CR6HT3 CRGHT3 " ; f i *; " C DOWN 3 EDO 
WND" 

1000 prinf'starting track :";tf 
1020 prinf'starting sector :";sf 
1040 print 

1060 print "file type 
1080 prinfinfo track 
1100 prinfinfo sector 
1120 print#5, "b-p: ";35bp+21 
1140 prinffile structure 
1160 print "geos f— type 
1180 if gt=l then print" =Basic" 
1200 if gt=2 then print" =Assembler" 
1220 if gtOl and gt<>2 then print 
1240 print "Year :";ja 
1260 print "Month !";mo 



Jit 
;is 

•;fs 
'jgt; 
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1280 prinf'Day :";ta 
1300 prinfHour ;"5ho 
1320 prinf'Minute :";mi 
1340 prinf'-file length :";ll+256»lh 

1360 input "CD0WN3CRGHT1CR6HT3CRGHT3<RETURN> to go 

on ";x*! return 
1380 rem tntt*tttt**t**ttt**t%**t*t** 
1400 print" CCLR]":t=18:s=l: 

1420 input" C DOWN 3 C DOWN 3 C DOWN 3 C RGHT 3 C RGHT 3 C RGHT 3 Nam 
e to search for:";su* 
1 440 5u=l en ( su* ) 
1460 print"CCLR3" 

1480 sv*=""!-fori = ltosus 5V=asc (mid* (su*, i , 1 )> : i-f 

sv>192 andsv<219 then sv=sv-96 

1500 sv*=sv*+chr* (sv) snexti s 

1520 print#5, "b-r: "3;0;t ;s 

1540 print#5, "b-p: "3,0 

1560 bp=2 

1580 gosub 2220 

1600 tn*=a*:tn=asc (tn*) 

1620 gosub 2220 

1640 na*="" 

1660 sn*=a*:5n=asc(sn*)si-fn*<>"i"then print"t=";t; 
" s=";s 

1680 print#5, "b-ps ";3;2 

1700 -for j = l to a 

1720 print#5, "b-p: "53;bp 

1740 gosub 2220: -f t*=a*: -f t=asc (-f t*) and 63 

1760 gosub 2220: ts*=a*: ts=asc (ts*) 

1 780 gosub 2220 : ss*=a* : ss=asc ( sst ) 

1800 for i=l to 16:gosub2220 

1820 i-f asc(a*)=160 then i=16:goto 1860 

1840 na*=na*+a*: 

1860 ne>;ti: 

1880 print#5, "b-p:";3;bp+19 
1900 gosub 2220: it *=a*: it=asc (it*) : 
1 920 gosub2220 : i s*=a* : i s=asc ( i s* ) s 
1940 i-f ■ft=0 then 2080 

1980 print" "j-ft;" ";ts;" ";s5;" "jchr* (34) ;na* 
5chr*(34) ; 

2000 print" "pit;" ";is 
2020 if n*="i" then 2080 

2040 i-f 5u*=mid*(na*, l,Bu) then print "CDOWN3CRGHT3 
CRGHT3 CRGHT3 CRGHT3 CRGHT3 CR6HT3 CRGHT3-f ound. " : z 1 = 1 : r 
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eturn 

2060 i-f sv*=mid*<na*, l,su) then pr inf ' CD0WN3 CRGHTl 
CRGHT3 CRGHTn CR6HT3 CRGHTl CRGHT3 CRGHT3-f ound" : z 1 = 1 : re 
turn 

2080 na*="": 

2100 if peek (203)064 then 2180 
2120 bp=bp+32 
2140 nextj 

2160 i-f tnOO then print"!:D0WN3"!t=tnss=5nsgQtol520 
2180 return 

2200 ren)*«*«t3|c«3K«$3ic«*t 

2220 get#3,a*:i4=a*=""thena*=chr*(0) 

2240 a=asc{a*) 

2260 return 

2280 rem$*«»$$««$««$>ic«««««:l$*« 
2300 f or k=0to62: poke832+k , Os nejctk 
2320 print"ECLRDCD0WN3Spritemaster" 
2360 >4l=0 :yl=0:x=Kl:y=ylsps=43 
2380 v>t=0: vy=0: vt=0 s 

2400 poke2040, 13!pokBV+21, 1 : pokev, 30: pokev+1 , 200 

2420 for j=xl+14 to x 1+23+14 

2440 for i=yl+l to yl+21 

2460 p=l 024+1*40+ j 

2480 gosub 3000s va%=vi%andvn% 

2500 i-f va% <>0 then ps=42 

2520 i-f va7. = then ps=46 

2540 i-f p>1024 and p<2023 then pokepj,p5 

2560 y=y+lsne>;t i s y=0 

2580 x=K+lsnextj!x=0 

2600 ps=43 

2620 p=1024+<y+l) «40+x+14 
2640 pr=peek{p) 

2660 i-fp>1023andp<2024 then pokep,ps 

2680 geta*: i-fa*=""then2680 

2700 i-f a*="CRGHT3"andK-<23 thenx=x + l 

2720 i-f a*="CLEFTD"andx>0 thenx=K-l 

2740 i-f a*="CD0WND"andy<20 theny=y+l 

2760 if a*="CUP3"andy>0 thBny=y-l 

2780 if a*="*" then pr=42: 

2800 if a*=" " then pr=46s 

2820 if a*="e" then 3120 

2840 if a*="CCLRD" then 2300 

2860 pokepjipr 
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2830 i-f a*<>"«"anda*<>" "then2620 
2900 gosub 3000 

2920 i-f a*="*" then pokevb"/., vi7. or vn7. 

2940 i-fa*=" " then pokevbX, viXandspX (vtX) 

2960 goto 2620 

2980 rem*****«******«««** 

3000 vy%=y s v){y.=int ( (x ) /8) s vt7.=x-vx7.«8 

3020 vbX=S32+VK7.+vy7.«3 : rem byte number 

3040 vi>i=peBk (vb%) srem contents 

3060 vn%=2T<7-vty.) srem new bit 

3080 return 

3100 rem tttt^.1ttttttt**%tt**t 

3120 pokev+21 , 0: pri nt " CCLR3 " s return 

3140 rem set date ««* 

31 60 print "C CLR 3 C DOWN 1 C RGHT 3 E RGHT 3 C RGHT 3 Z RGHT 3 C RGH 

T3CRGHT3ERGHT3 D A T E 

31 SO print" C RGHT 3 C RGHT 3 C RGHT 3 Z RGHT 3 C RGHT 3 C RGHT 3 C RG 
HT 3 C RGHT 3 Z RGHT 3 Z RGHT 3 C RGHT 3 " ; mo* ; ' V" ; t a* ? " / 1 9 " s j a* 

";ho*fi "E ";mi*; " o'clock" 
3200 rem print " CRGHT3 CRGHT3 CRGHT3 CRGHT3 CRGHT3 CRGH 
T3 CRGHT3 CRGHT3 C RGHT 3 C RGHT 3 C RGHT 3 " ; ta; 
3220 print"CDOWN3CDOWN3" 
3240 pr i n t " C RGHT 3 Z RGHT 3 C RGHT 3 Year 
3260 print " C RGHT 3 C RGHT 3 [RGHT3MDnth 
3280 print "E RGHT 3 E RGHT 3 E RGHT 3 Day 
3300 pr i n t " E RGHT 3 E RGHT 3 E RGHT 3Hour 
3320 print" ERGHT3ERGHT3ERGHT3Minute 
3340 print"ERGHT3ERGHT3ERGHT3EDOWN3Change - type f 
irst two characters of choice <YE MO, etc.) 

3360 print"ERGHT3ERGHT3ERGHT3Done - type END 
3380 input " E DOWN 3 E DOWN 3 E RGHT 3 E RGHT 3 E RGHT 3 Your cho 
i ce" ; X* 

3400 i-f x*="Bnd" then return 

3420 if x$="ye" then input " E DOWN 3 E DOWN 3 E RGHT 3 E RGHT 

3ERGHT3Year s " ; _ia*: ja=val < ja*) s gotD3160 

3440 if x$="mo" then input " ED0WN3 ED0WN3 ERGHT3 ERGHT 

3ERGHT3Month : " ; mo*! nio=val <mo*) sgDto3160 

3460 if x*="da" then input " ED0WN3 ED0WN3 ERGHT3 ERGHT 

3ERGHT3Day : ";ta*5ta=val <ta*) 3goto3160 

3480 if >{$="ho" then input " ED0WN3 ED0WN3 ERGHT3 ERGHT 

3ERGHT3Hour ; "5hD*!ho=val (ho*) 5goto3160 

3500 if K*="mi" then input " ED0WN3 ED0WN3 ERGHT3 ERGHT 

lERGHTDHinute s ";mi*smi=val (mi*) sgDtD3160 

3520 goto 3160 
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3540 print' 'CCLR3":rem ****«geos file set**** 

3560 i-f itOO then 3660 : rem should be set 

3580 it=t-f sis=s-f :printit,is 

3600 print#5, "b-a: "0;it;is 

3620 input#5,a,b$,c,dsprinta,b$,c,d: 

3640 if c<> O then i t=c! is=d; goto 3600 

3660 pr i n t " C DOWN 1 Z DOWN 1 1 DOWN 1 C RGHT 1 C RGHT 3 C RGHT D C RG 

HTDPlease input GEOS filetype:" 

3680 input"CDOWN3CRGHTDCR6HT3CRGHT3CRGHT3Basic=l M 

/L=2 Acc.=5 Appl .=6";x*:x=val (X*) 

3700 if x<l and x >6 then 3660 

3720 fs=0:gt=x 

3740 print#5, "b-f s "05it;is 

3760 print#5, "b-r: ";3;0;at;as 

3780 print#5, "b-p: "3,ab+19 

3800 print#3,chr*(it) ; 

3820 print#3,chr*<is) ; 

3840 print#3,chr*(f s> ; 

3860 print#3,chr*(gt) ; 

3880 print#3,chr*(ja) ; 

3900 print#3,chr*(mo) ; 

3920 print»3,chr*(ta) ; 

3940 print#3,chr*(ho) ; 

3960 print#3, chr* (mi ) ; 

3970 if at<l or at>35 then print"CDOWN3CRGHT3CRGHT 

3CRGHT3ERROR: Illegal track" : goto4040 

3980 pr i nt#5, "in-w: "chr* <6) chr* <0) chr* (2) chr* <at ) ch 

r*(as) 

4000 pr i nt#5, "m-w"chr* (O) chr* (O) chr* ( 1 ) chr* ( 144) 
4020 pr int " cboWNl CRGHT3 CR6HT3 I:RGHT3 CRGHT3 CRGHT3 CRG 
HT 3 C RGHT 3 wr i 1 1 en " s 

4040 input " C DOWN 3 < RETURN > to continue" 5 x*: return 

4060 rem tttlook for dir & sprite*** 

4080 print"CCLR3"!t=lS:5=l!ifn*="dir"then 4200 

4 1 00 i nput " C DOWN 3 C DOWN 3 C DOWN 3 C RGHT 3 C RGHT 3 C RGHT 3 Nam 

e to search for:";su* 

4120 su=len(su*) 

4140 print "CCLR3" 

4160 sv*="":f ori=ltosu:sv=asc (mid*(su*, i , 1 ))!if s 

v>192andsv<219then sv=sv-96 

4180 sv*=sv*+chr* (sv) :nexti s 

4200 print#5, "b-r: "3;0;t ;s 

4220 print#5, "b-ps "3,0 

4240 bp=2 
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4260 goBub 2220 

4280 tn*=a*;tn=asc(tn*) 

4300 gosub 2220 

4320 na*="" 

4340 sn*=a*:sn=asc (sn*) s i-fn*<>"dir"then print"t="s 
t;" s=";s 

4360 print#5, "b-ps "53;2 

4380 for j=l to 8 

4400 print#5, "b-p: "53[|bp 

4420 gosub 2220; f l*=a*: f l=asc (f 1*) and 63 

4440 gosub 2220: 

4460 gosub 2220: 

4480 -for i = l to 16: gosub 2220 

4500 if asc(a*)=160 then i =16: goto 4540 

4520 na*=na*+a*: 

4540 nexti: 

4560 print#5, "b-p: ";3;bp+19 
4580 gosub2220: i l*=a*: i l=asc (i 1*) : 
4600 gosub2220s i2*=a*: i2=asc (i2*) : 
4620 i-F -fl^O then 4740 

4640 if n*="dir" then print "[RGHT3CRGHTDCRGHT3CRGH 
T3";na*:goto4740 

4660 print" "| chr* (34) ; na*; chr* (34) 
4680 if n*="dir" then 4740 

4700 if su*=mid*(na*, l,su) then pr int " CDOWNl CRGHT3 
CRGHT3 CRGHTD CRGHT3 CRGHT3 CRGHT3 CRGHT3Found" : goto 49 

00 

4720 if sv*=mid*(na*, l,su) then print "CDOWN3CRGHT3 
CRGHT3 CR6HT] CRGHTa CRGHT3 CRGHT] CRGHTlFound " : goto 49 

00 

4740 na*="" 

4760 if peek (203)064 then 4860 
4780 bp=bp+32 
4800 nextj 

4820 if tnOO then print"CD0WN3":t=tn:s=sn:gDto420 
O 

4840 if n*<>"dir"then print "CD0WN3CRGHTDCRGHTDCRGH 
TlSorry, not found. " 

4860 input "CDOWN]<RETURN> to continue" 5 k*: return 
4900 rem *** read sprite*** 

4920 pr i n t " E CLR 1 Z RGHT 1 C RGHT 2 L RGHT 3 C RGHT 3 C RGHT 3 C RGH 
T3 : RGHT 3 C RGHT 3 C RGHT 3 C RGHT 3 C RGHT 3 C RGHT 3 C RGHT 3 C RGHT 3 
CRGHT3Read sprite[UP3" 

4940 if i 1=0 then print"CCLR3sprite not yet define 
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d"!-forz2 = lto 1000!next:goto5080 
4960 print#5, "b-r: "3;0; i 1 ;i2 
4980 print#5, "b-p: "3,5 
5000 for i=0 to 62 
5020 gosub 2220 

5040 poke832+i,asprinti,a5 "EH0ME3" 
5060 neKti: 
5080 return 

5100 rem***read in-fo screen***** 

5120 if it=0 then return: rem track=0 

5140 print#5, "b-r: "3;05it;is 

5160 print#5, "b-ps "3,0 

5180 f ori=lto6:a*<i ,2)=""snexti 

5200 gosub 2220: if a<> O then 5600 

5205 gosub 2220: if a<>255 then 5600 

5210 gosub 2220: if a<> 3 then 5600 

5215 gosub2220: if a<>21 then 5600 

5220 print#5, "b-p: "3,71 

5240 gosub 2220: K=a 

5260 gosub 2220: x=x+256«a 

5280 a*<l,2)=str*(M) 

5300 gosub 2220: x=a 

5320 gosub 2220: M=x+256*a 

5340 a*(2,2)=str*(K> 

5360 gosub 2220 :x=a 

5380 gosub 2220: x=x+256*a 

5400 a*(3,2)=5tr*(x) 

5420 gosub 2220s if a=0 then 5460 

5440 a*<4,2>=a*<4,2)+a$:goto 5420 

5460 print#5, "b-p: "3,97 

5480 gosub 2220:ifa=0 then 5520 

5500 a*(5,2)=a*<5,2)+a*:gQto 5480 

5520 print#5, "b-p: "3, 160 

5540 gosub 2220:ifa=d then 5580 

5560 a*<6,2)=a* (6,2)+a*sgotD 5540 

5580 rem 

5600 rem **** create info screen ****** 

5620 a*(l, l)="CDOWNlCRGHT3CRGHT3i Load address 

m 

5640 a*<25 l)="tDOWr^41CRGHT3i:RGHT:2 End address 

5660 a«(3, 1)="ED0WN3ERBHT1I:RGHTD3 Entry point 

5680 a$<4, l)="CDOW!M3CRGHT3ERSHT34 Class 
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5700 a*(5, 1)="CD0WN3CRGHT1CRGHT35 Author's name 
■ >* 

5720 a*(6, l)="CDOWN3CRGHT3CRGHT36 Help screen 

5740 rem****************************** 

5760 p r i n f • C CLR 1 E DOWN 3 C RGHT 1 C RGHT 3 C RGHT 3 C RGHT3 C RGH 

T 3 C RGHT 3 1 RGHT 3 C RGHT 3 C RGHT 3 C RGHT 3 C RGHT 3 Great e I n-f o 

Screen" 

5780 -for i =1 to 6: pr inta* ( i , 1 ) ; a* (i , 2> : nexti 
5800 input"i:DOWN3CDOWN3CRGHT3CRGHT3CRGHT3Input num 
ber or E to end 

5820 H= K*="e" then print " CCLR3 goto6000 

5840 i-f val (>{*)<! or val <;<*) >6then5760 

5860 print"CDOWN3CDOWN3CRGHT3";a*(val (K*> , 1) ; " ";a 

*(val (K*> ,2) 

5880 printtab(21);"CUP3"; 

5900 i-f len<a*(val (K*) ,2) > >19 thenpr int " tUP3 " ; 
5920 input a$ (vai (k*) , 2) 
5940 goto 5760 
5960 rem 
5980 rem 

6000 print#5,"b-p5 "3,0 

6020 print#3,chr*(0) 5chr*<255) 5chr*(3) ?chr*(21) ;ch 
r*(i91); 

6040 -for i=0 to 62 

6060 print#3,chr*>:peek (S32+i ) ) ; 

6080 nexti 

6100 print#3,chr*(^t+128> ; 

6120 print#3,chr*<gt) ; 

6140 print#3,chr*(-f5) 5 

6160 if gt=l then goto 6340 

6180 rem >{*=a* ( 1 , 2) s gDSub6720 

6200 rem priftt»3, chri (x2> ; chr* (x 1 > ; 

6220 K*=a*(l,2) sgosub6720 

6240 print#3,chr*(x2) ;chr$(;<l) ; 

6260 >;*=a*(2,2> sgDsub6720 

6280 pr int#3, chr$ (k2> ;chr*(>;l> ; 

6300 >;*=a* (3, 2) s gosub6720 

6320 print#3,chr*(K2) ;chr$(xl ) 5 

6340 >;=len<a*(4,2) ) :if >;>19 then x = 19 

6360 print#5, "b-ps "3,77 

6380 for i = l to ;< : K$=mid* (a* (4, 2) , i , 1 ) ; pr int#3, >;*; 
6400 nexti s pr i nt#3, chr$ (0) ; 
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6420 x=len <a*(5,2) ) si-f k>19 then j< = 19 
6440 print#5, "b-p: "3,97 

6460 -for i = l to x : K*=mid* (a* (5, 2) , i , 1 ) s pr int#3,K*|i 

6480 nexti : print#3, chr* (O) ; 

6500 x=len(a*<6,2)):i-f k >40 then j<=40 

6520 print»5, "b-p: "3, 160 

6540 -For i = l to x : K*=mid* (a* (6, 2) , i , 1 ) : pr int#3, x*; 
6560 nexti : print#3, chr* (O) ; 

6570 if it<l or it>53 then print" False track":got 
O6680 

6580 print#5, "m-ws "chr* (6)chr* (O)chr* {2)chr* (it )ch 
r*(is) 

6600 pr i nt#5, "m-w"chr* <0> chr* (O) chr* ( 1 ) chr* ( 144) 

6620 print " CDOWNl CRGHTl CRGHT3 CRGHT3 CRGHT3 CRGHT3 CRG 

HT 3 C RGHT D Wr i 1 1 en " : 

6640 print#5,"b-a:"0;it;is 

6660 input#5,a,b*,c,d:printa,b*,c,d: 

6680 input"cb0WN]i:R6HT3CRGHTilCRGHTD<RETURN> to con 
tinue" ; x* 
6700 return 

6720 x=val (x*) :xl=int (x/256> sx2=int (x-xl*256 ) 
6740 return 

6760 datal27, 191,223,239,247,251,253,254 
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5.2.2 Description of the FILEMASTER program 



If all you want to do is use FILEMASTER, then you can probably skip this 
section. On the other hand, if you want to alter the program or use parts of it 
in your own programs, then you should definitely study this listing for its 
content. Before you do, you should be familiar with BASIC and all of the 
commands. 

40 Input of 8 values in the SP% field. These values are used 

by the sprite master to clear specific pixels of the sprites. 

60 Clear the screen. 

80 v=starting address of the Video controller. Register 21 

turns the sprites on or off. turns ail the sprites off. 

100-120 Wait until a key is pressed. Used at places where a diskette 
change is needed during the course of the program. 

140 Open and initialize the command channel for the diskette. 

This is where the diskette RAM is written to in the program 
buffer. For more information see The Anatomy of the 1541 
Disk Drive or 1571 Internals. 

160 Open the channel to the disk drive. This channel will use 

buffer ($0300-$03FF). 

1 80-480 Display the menu. 

500 The input variable N$ is set to a value, which is not 

available in the menu. This prohibits any erroneous 
possibilities when choosing a menu item. 

520-720 Input and jump to the appropriate subroutine. 

740 After retuming from the subroutine, or in the case of bad 

input, redisplay the menu. 

760 Jump here if the input value END is entered. This closes 

both channels and halt the program. To restart the 
program, all you would need at this point is a GOTO 100. 
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800- Subroutines: File searches and data display. 

800 Z1=0 means that no file entry has been found. After an 

entry is found in the subroutine at 1380 the variable Zl is 
set to 1. If z 1=0, control is returned to the menu. The 
same thing happens if T=0, that is, if the actual track is 0. 
This would mean that a search of the diskette at track 
would cause an eiror. 



820 This variable stores the track information where the file 

entry is located. This variable is really unnecessary, since 
the directory for the diskette is always located on track 18. 
As a matter of review for later, we store this value anyway. 

840 The sector where the file entry was found. 

860 Each disk buffer contains a pointer, which points to the 

next byte to be read. AB contains the position of the first 
character of the file entry (this is also the file type.) 

880 The starting track of the program is stored in TF, and the 

starting sector is stored in SF. 



900 The variable NA$ contains the name of the file entry. The 

full name is actually found in the variable F I $ . If you were 
looking for the file entry ALARM CLOCK, all you need is 
ALA. This would point to the full name ALARM CLOCK. 

920-960 The information that GEOS uses in read in at this point. 

The subroutine at 2200 is called, which returns a character 
and the associated ASCII value, these reside in A$ and A. 

980-1340 The portion of the program where the data in the file entry 
points. All of the information of the file entry is stored 
here. Those files which are not stored in the GEOS file 
format will have all zeroes. The variables JA, MO, TA, HO, 
and MI have the date and time. 



1360 Wait until all of the information is read in, then return to 
the menu. 



1380- Subroutine: Search for the file entry in the directory. 
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1400 Clear the screen, and set the actual track and sector to 18 
and 1, respectively. 

1420-1500 The name of the needed file entry is in SU$. At the same 
time the altered form is in SV$. Since GEOS codes every 
character strangely, all GEOS file entries will not be found. 

1520 Put the current track and sector into buffer 0. 

1540 Set the buffer pointer to the beginning of the buffer. With 
this we can read or save the track and sector of the next 
blocks in the directory. 

1560 Set the variables for the buffer pointers to the beginning of 
the first file entry. 

1580-1600 Read in the starting track of the next block and put in TN.. 

1620-1660 Read in the starting sector and put in SN.. The actual file 
name is cleared (NA$=" "). 

1680 Sets the buffer pointer, in this case, to the start of the first 
file entry. 

1700 Loop through the eight entries in the sector of the 
directory. 

1720 Set the buffer pointer to the correct value. This value is 
calculated at 2120. 

1740 Get the file type. If the file is protected against deleting, the 
value FT is compared with 63 using the AND operator. 
This will not affect either of the first two bits. 

1760-1780 Get the track and sector of the first data block. This is also 
the beginning of the actual program to which the file entry 
belongs. 

1800 Loop through the 16 possible characters of the file entry: 
Get one character. 

1820 If the character is a <SHIFT>ed <SPACE> (ASCII=160), 
then the name is finished. 
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1 840 Puts the filename together from the individual characters. 
1860 End of the loop. 

1880 The buffer pointer is set to the first character after the 
name. This is where GEOS puts its additional information. 

1900-1920 Get the track and sector of the info box from the file entry. 

1940 If FT(File type)=0, then the file has been erased. In this 
program, we don't care about erased files. However, this 
could be used to your advantage to save erased files in 
other programs. All you would need to do is add the line: 
IF FT=0 THEN FT=2. Naturally, it is possible for 
another program to have written over the file since it was 
erased. Then again, maybe a new file wasn't written over 
the file, in which case the file can be salvaged. 

1980-2000 The name and other important information is displayed on 
the screen. This allows you to see if the subroutine did 
actually find the file we're interested in, or if it found 
something else by mistake. 

2040 Make sure that the name of the file found is the same as the 
file the user originally asked for. To do this we will only 
use the full name in SU$. If the names agree then Zl=l 
and the routine ends. 

2060 Check the altered characters in the GEOS file entry. 

2080 The actual name is cleared. This is important, since the 
individual characters were stored earlier. If they weren't 
cleared, the name would continue to grow. 

2100 If you want to break the search, all you need to do is press 
a key. Then the location 203 is unequal to 64 and the 
subroutine is ended. This would be important if you 
mistyped the filename and don't want to wait for the 
program to realize the file doesn't exist. 

2120 Sets the variable for the buffer pointer to the beginning of 
the next file entry. 
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2 140 End of the loop for all eight file entries. 

2160 If the file entry is not found in this block of the directory, 
then the variables TN and SN are used to move to the next 
block. This will allow us to continue to search for the file 
entry. 

2180 The file entry is not found. We reached the end of the 
directory and the subroutine ends. 

2200-2280 Get a character from the disk buffer and put it in A$ and 
the ASCn equivalent in A. 

2300- Clear the sprite block. 

2360-2380 Set the variables for the coordinates of the beginning 
values. 

2400 The information for sprite 1 is in block 13 (13*64=832). 

Sprite 1 is turned on and the coordinates are set to 30, 200 
(lower left comer). 

2420- Also, an enlarged picture of the sprite appears on the 
screen. This rectangle takes up over half of ttie screen. 

2420 Loop through all colunms of the enlarged sprite. 

2440 Loop through each line. 

2460 P=actual position on the screen. 

2480 Get the contents of the actual byte (Vl %) in the sprite block 
and the position of the appropriate pixels (VN%). VA% is 
if this pixel is set 

2500 If the pixel is set, then the character on the screen is a " 

2520 If the pixel is not set, then the character is a . (period). 



164 



I 



Abacus Software 



GEOS Inside and Out 



2540 If the position is inside of the screen, the character is saved 
in the screen memory. This opens possibilities of changing 
the size of the rectangle, or even restoring the screen if any 
error occurs. 

2560 next row 

2580 next column 

2600 43 is the value for a This cross appears in the actual 
location. 

2620 Calculate the memory location in the screen memory for the 
actual position. 

2640 The contents of this memory location is saved in PR, and 
the 43 for the cross is placed in the screen memory. 

2660 If the position is inside of the screen memory, then the " +" 
is placed in this position. 

2680 Wait until a key is pressed. 

2700 <CRSR RT> : If the right hand edge hasn't been reached, 
then the position of the cross is moved to the right by one 
location. 

2720 <CRSRLFT> 

2740 <CRSRDN> 

2760 <CRSRUP> 

2780 If a * is pressed, a pixel is set at that location, and the 
saved location is changed to a *. 

2800 The spacebar can clear the location (ASCn=46). 

2820 The <E> key wiU end the work with the sprite master. 

2840 Pressing the <SHIFT>ed <CLEAR/HOME> combination 
clears the sprite. This makes life easier if you want to start 
over. 
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2860 Return the saved character to the same position. This can 
be changed with a <*> or a <SPACE>. 

2880 If the last key pressed was a cursor key, then the polling is 
restarted. NotWng is changed. 

2900 Otherwise, the subroutine at 3000 places the actual 
contents of the bytes into sprite block (VI %) and the actual 
bit in (VN%) and the position in (VT%). 

2920 If a pixel was set, then the content of the sprite is ORed 
with the new bit. 

2940 To erase a pixel you have to use the correct mask in the 
field SP% (position of the bit), and then clear it with an 
AND operation. The eight values for SP% are in the DATA 
statements at the end of the program, and are differentiated 
by flie lack of a one in each of the eight bit locations. 

2960 Return to the question loop 

2980-3 100 Calculate the position of the pixel in the sprite block which 
is in the enlarged sprite rectangle. 

3120 End of work with the Sprite Master. The sprite is saved 
and we retum to the menu. 

3 140- Subroutine: Set date 

3160-3180 Show the title and other data. 

3200-3360 The values are shown on the screen. Using the first two 
characters, the value can be changed (for example: DA for 
DAY)* and entering END to exit the program. 

3380-3520 After changing a value, save the value and redisplay the 
data. 

3540- Subroutine: Change the file into the GEOS format. 

3560 If the variable IT is not a 0, then the info box is already 
installed and the change doesn't take place. 
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3580 IT, IS are track and sector of the info box. The starting 
value is set and displayed. 

3600 This sector is checked to make sure that you are not going 
to overwrite anything. If you will, then a disk error is 
announced, and fiie next free sector is displayed. 

3620 Read the disk error report 

3640 If an error does occur, then C=0. Otherwise, C is the track, 
and D is the sector of the next free blocks. 

3660-3700 Your are asked for the GEOS file type. Although GEOS 
knows more than just six file types, tihis program will only 
take values between 1 and 6. 

3740 The sector for the info box is returned to free space. 

Otherwise, the diskette must be searched for another free 
sector. This section looks for the free sector for the same 
file entry. 

3760 The block containing the directory for the file entry, must 
be reread into the disk buffer. Now the changes can be 
made to the file entry. 

3780 Set the buffer pointer to the first byte behind the filename. 

3800-3960 Write the changed value to the buffer. 

3980-4000 These two lines write the buffer to the diskette. Now, the 
change has been made and saved on the diskette. In this 
case we would want to use the command 
(B-W : ) 3 ; / AT ; AS. Of all things, this command is not 
very reliable. It saves the first character incorrectly. Since 
we want a very reliable, error-free program (especially at 
this point), we did not use this command. 

Warning: This command is a powerful tool. It can totally erase your 
diskette if misused . If you want to change FILEMASTER, 
please use the following guidelines: 
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• Never switch the order of the two lines. 

• Never allow AT to become larger than 35. This 
command will allow you to write to tracks over 35. 
The floppy head could reach the end of the diskette 
and strike the back of the drive, which can damage 
the drive. 

4020-4040 Information about the write operation and return to the 
menu. 

4060-4860 This subroutine is used in conjunction with the file search 
at line 1400. There are two differences between them: 

• If the subroutine is called from the menu, then 
N$=" I " and the actual name of the file is in NA$, 
and no other information is found. At the end of the 
routine, control is given back to the main program. 

• If the subroutine is called from the sprite input, then it 
will search for the file entry, and if found it jumps to 
the routine at 4900. Otherwise it will return to the 
menu. 

4900 Subroutine to input sprite. 

4940 If the file entry did not have an info box, then IT=0, and 
the sprite is not read. 

4960 Get the sector of the info box in the buffer. 

4980 Set the buffer variable to the beginning of the sprite. 

5000-5080 Read in the 64 bytes of the sprite from the buffer and write 
it to block 13. Afterwards return to the main menu. 

5 100 Subroutine: info box input, change and save. 

5 120 If the file entry does not have a pointer to the info box, the 
subroutine ends and retums to the menu. 

5 140 Read the sector with the info box into the buffer. 
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5 1 60 Set the buffer pointer to the first byte of the buffer. 
5 1 80 Set the text to the value . (period). 

5200-5215 Test the first four bytes of the sector. These must have 
special values— otherwise this sector does not contain the 
info box. If everything is as it should be, then the text 
should be 0. Otherwise, if the sector does not have the info 
box, then there will not be 0. If this is the case, then the 
remaining text is skipped. 

5220 Set the buffer pointer to the beginning of the output text in 
the info box. 

5240-5560 Read the remaining six values. The final value is 
recognized as a 0. This would be a problem, if the info 
box was not in the sector. 

5600-5720 The text is all in a single field. Therefore you can use a 
loop to output the values. 

5760-5780 Output loop for the title and text. 

5800 Input the number to change or END to quit. 

5820 If the answer is END, then change the buffer and rewrite it 
to diskette. 

5840 Check the converted number and check for legality. 

5860-5920 Enables text editing. The text is output to the screen and the 
cursor for the INPUT command is placed so that the 
contents can be changed. 

5940 Output the edited text. 

5980- Change the values and rewrite the text to the buffer. 

6000 Set the buffer pointer to the start of the buffer. 

6020 Set the first bytes. The entire story behind the values can 
be found in Chapter 6, Inside GEOS. 
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6040-6080 Read the values for the ICON in the sprite block into the 
buffer. 

6100-6560 Write the text into the buffer and set the text to 0, 

6570 The value IT is checked for legality for both of the next 
commands, 

6580-6620 Rewrite the buffer. 

6640 Identify the sector with the info box. 

6660 Output the error message to the screen. 

6680-6700 Retum to the menu. 

6720-6740 Change the value in x$ into two numbers in the format 
fflGHbyte/LOWbyte. 

6760 The value to clear individual pixels in the sprite is in the 
SP% field. 
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5.2.3 The FILEMIISTER menu 



After FILEMASTER is started, as well as any time a key is pressed, a menu 
is displayed on the screen. Here are the options: 

DIRECTORY = DIR 

This menu option displays the directory of the diskette. The name and the 
diskette ID are displayed. You can halt the output of the directory by 
pressing any key. The best keys to press are the function keys (F1-F8), 
since these do not print anything on the screen. FILEMASTER checks the 
keyboard only after each complete file entry is displayed. This is to make 
the input go faster. To retum to the main menu, press the <RETURN> key. 

LOAD A SPRITE = SPL 

This option loads an existing icon from any GEOS file and stores it in the 
sprite block. You can store the icon as it is, or change it any way you wish. 

First of all, F ILEMASTER asks you to enter the name of the program that 
contains the icon. Enter the name as it appears in the directory. If the file is 
not found on the working diskette, select the option on the menu to switch 
diskettes. If you switch diskettes, after FILEMASTER is finished use the 
menu option D I SK to retum to the working diskette. 

When you enter the name of the file, FILEMASTER searches the file entries 
on the diskette, and points to the name. If the program is found, then the 
message reading sprite appears, followed by the number - 63. 
Afterwards, the menu reappears. If the file is not found, the menu 
automatically reappears. 

CREATE A SPRITE = CSP 

This option allows you to create a new icon, or to edit a previously-loaded 
sprite. You should know that a sprite is made of 63 values (bytes). Every 
byte is composed of eight bits; each bit describes a pixel. Therefore 
63*8=504 pixels form a single sprite. The sprite generator makes creating a 
sprite very easy. By starting the sprite generator, you can see what happens 
as you read along. 
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The right hand area of the screen displays a matrix (a rectangle) that 
represents the sprite. If the sprite block at 832 is empty, then you have not 
loaded a sprite. This rectangle is 24 pixels by 21 pixels (a total of 504 
pixels). If you enter a sprite, it appears in the lower left comer. Each pixel 
in the matrix is represented by a *. A cross appears in the upper left comer. 
This cross is the pointer to the position in the sprite as well as the cursor to 
set the pixels. 

For example, if you want a * in a position, then move the cross to that 
location, press the * key and then press the <CRSR RT> key. This is what 
happens: 

1) Cursor keys: Moves the cursor within the matrix. This is the 
means of changing individual pixels. 

2) <*> (asterisk) key: Sets the pixel at a given location. This also 
sets tiie appropriate bit in the sprite block. The cursor does not 
change position. 

3) <SPACE> bar: Clears a pixel in the sprite block. 

4) <SHIFT><CLR/HOME>: In BASIC this key combination 
would clear the entire screen. In sprite master this clears the 
entire sprite. So if you want to start over, tfiis is the quickest 
way to reset the sprite. 

5) <E>: Ends the operation of the sprite master program and 
retums to the menu. The sprite is no longer pointed to in block 
13 — however, it is not cleared. If you want to use the sprite 
master later, then the sprite is still there for you to use. 

READ FILE: RFL 

This conmiand reads a single file entry from the diskette. Enter the filename, 
and F ILEMASTER searches the diskette and displays the contents of the file 
entry. 

To find the name, you need only enter enough characters for the program to 
recognize the file you want. To find a file named ALARM CLOCK, you 
would only have to enter the three characters ALA. If the program cannot 
find the entry with these three characters, then you would have to enter the 
entire filename for the search. 
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If the file is not in the directory, then FILEMASTER returns to the menu. 
Otherwise, all the information in the directory will be displayed. These are: 

1) Starting track and sector: 

Track and sector where the file starts on the diskette. 

2) File type: 

Normal DOS file type; 0=DELETED, 1=SEQUENTIAL, 
2=PROGRAM, 3=USER, 4=RELATIVE. On the original 
GEOS diskette, all files outside of GEOS and GEOS BOOT are 
USER files. 

3) info track and sector: 

Track and sector of the info box. If both are set to 0, then there 
is no info box. 

4) File structure: 

GEOS recognizes two file structures: SEQUENTIAL=0 and 
VLIR=1. For your programs you should always use sequential. 

5) GEOS filetype: 

0=BASIC, 1=ASSEMBLER. For more file types see the 
INSIDE GEOS. However, the way the program is written then 
only use a or a *r. 

6) Date: 

The date is stored in five parts: Year, Month, Day, Hours and 
Minutes. 

7) Length of file: 

The number of sectors is the amount used by the file on the 
diskette. 

After you press the <RETURN> key, FILEMASTER returns to the menu. 



DISPLAY FILE D^O: FDI 

This command shows all of the information in a file entry. This command 
works only if a file has been read. 
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CREATE GEOS FILE: GEOS 

This command converts the data in the file entry on the diskette. The 
program searchs for an unused block to store the info box. All you have to 
do is enter the date. After this is finished, the word WRITTEN appears on 
the screen. Pressing <RETURN> will bring back the menu. 

INPUT/CHANGE DATE: DATE 

This displays the date of the file, and allows you to change it The default is 
0. You can change any entry by entering the first two characters of the field 
name. For example: entering an HO will allow you to change the hour. You 
can exit this subroutine by entering the command END. 

CHANGE DISKETTES: DISK 

This command allows you to convert a file that is on a different diskette than 
the work diskette. After the diskettes are changed, control is returned to the 
menu. 

END PROGRAM: END 

Use this to leave the filemaster program. Don't exit the program by 
pressing the <RUN/STOP> key. It's possible that something might not be 
completely stored, and the information could be lost if the program is not 
exited properly. 

READ INFO: INFO 

This command readies the info box. Before you can use this option, you 
must have either loaded an existing sprite, or created one using the sprite 
master routine. The FILEMASTER program checks the sector where the file 
entry said the info box is supposed to be. 

After the info box is finished, then you can change the six variables. If your 
program is written in BASIC, then don't use the first three. These won't be 
used by GEOS, and therefore should not be written to diskette. 

If you are finished with the input, then type E to end. The saved or altered 
info box wiU be written to diskette. 
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5.2.4 Using FILEMZ^TER 



The FILEMASTER program alters the contents of the file directory on a 
diskette. We suggest that you copy the programs to be converted to a single 
work diskette* Use the work diskette for this purpose. You can then copy 
the changed programs to whatever diskette you wish later. 

First, copy the program to the work diskette. Then load the filemaster 
program, and start it with RUN. Insert the work diskette and press any key; 
the menu appears. To convert the program to the GEOS format, simply 
perform the following steps: 

Read the file with the RFL command. We will assume that the program is a 
BASIC program. 

Now create or load a sprite for the GEOS file. If you need to change 
diskettes, then use the CDSK command. 

Use the date command to set the date of the file. Begin by setting the year 
with the YE command. F ILEMASTER will then prompt you for the year. 

Warning: When entering date information, be careful that you enter correct 
data — FILEMASTER does not check the validity of the date. If you enter 
something like 1 2 3 4 5 6 7 8 9 for the month, it will destroy the locations of 
everything else in the file entry, and the GEOS format is also destroyed. 

Now choose the GEOS command to actually perform the conversion. The 
message 65 NO BLOCK is displayed on the screen. This is normal; if s 
telling us that FILEMASTER is searching for a free block to store the info 
box. Finally the message OK is displayed. Enter a 1 for the file type 
for BASIC. The last thing to appear on ttie screen is the word written, 
which tells us that the file has been converted. 

If everything went perfectly, but there is still no info box for this text, then 
the following message is displayed: 

OK 
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If the info sector is written, then the message: 
65 NO BLOCK (and two more numbers) 
is displayed. Then the block is correctly written. 

Now, you can either quit FILEMASTER or convert another file if you wish. 

The last thing you will do is copy the GEOS file to the work diskette, where 
you can use your program. 

Finally, we want to leave you with some tips for working with 
FILEMASTER. 

As you read through our code, you undoubtedly came across a few 
opportunities to change our program. To do this you will have to change at 
least one line of code. We wrote the code so that it is easily understood and 
very flexible, so that you can make the changes you want 

If you accidentally erase a file on your GEOS diskette, then you can recover 
it with F ILEMASTER. This will only work if you have not saved any files 
on top of the one you want to recover. When you delete a file, the contents 
of the sector it occupied are not cleared. Rather, a file type of is stored in 
the file entry, and the sectors of the file are freed for use. When you change 
the filetype, tiien the file is restored and ready to use. 

If you want to include these features in FILEMASTER, all you have to do is 
change the following lines: 

old: 1940 IF FT=0 THEN 2080 
new: 1940 IF FT=0 THEN PRINT 

Now the cleared files are not overwritten, and can be restored. Doing this 
marks the file to be restored. 

Now change the file type from to another value: 



new: 


3765 


IF 


FT=0 THEN PRINT#5, "B-P:"3,AB: 


new: 


3770 


IF 


FT=0 THEN PRINT#3, CHR$(130)/ 


old: 


3720 


FS= 


=0: GT=X 


new: 


3720 


GT= 


=X 
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This will change the file type to a legal value. It is rewritten to the buffer at 
line 3980 and is changed on the diskette. This will cause one problem: 

After we have altered a program with the GEOS command and set the info 
box with INFO, GEOS loads the command VALIDATE. This command 
checks the sector of the saved file, and makes sure the file was saved 
correctly. 

We will go through how this takes place with a short example: 

Pretend you have a text file you created named CONCEPT with geoWrite 
and have since erased. Now, quit GEOS and start up BASIC. Load 
FILEMASTER and make the changes described above. Insert the diskette 
with the "missing" file in the drive with the missing file. Enter RFL and the 
name CONCEPT. If the program is found, then the important data would be: 

File type: 
GEOSF-Type: 7 
File structure: 1 

Now choose the GEOS option from the menu, and change the file type from 
to 7. Finally, save the change, and leave FILEMASTER. Reboot with 
GEOS. Insert the altered diskette in the drive. Select the command 
VALIDATE. Now you can either work on your data again, or print it. 

In the GEOS file types, the program can only figure types 1 through 6. Line 
3700 checks the values. If you want to recognize the ACCESSORY file type, 
simply change line 3700 to check for whatever types you want (in this case 
GT=7). You are still responsible for making sure diat the file type you enter 
is a correct value. If you give a text file the file type for a BASIC program, 
GEOS will try to load the file as a program and then try to run it. Odds are 
that the text will hang up the program and crash the computer. 

If you want to change a GEOS file (like the date or your name as the 
progranmier), read the file in first (RFL), then read the sprite in (SPL). 
Now you can change your file and not worry about losing your sprites. 



177 



Abacus Software 



GEOS Inside and Out 



53 The function of the real-time clock 



GEOS uses at least one of the two real-time clocks in the '64. This clock's 
greatest advantage over the KERNAL-operated TI$ clock is its relatively 
high frequency. This is similar to the way your clock/radio uses the 
altemating current from the outlet for synchronization. 

But clocks run 'Taster" in America than they do in other parts of the world, 
like Great Britain, Australia, and Germany. The clocks of these intemational 
Commodore owners run two seconds slower in a ten-second span than 
U.S. machines. 

As you know, this discrepancy is due to the fact that European current 
alternates 10 Hz slower than the rate of U.S. current. Unfortunately, the 
GEOS developers have not been able to correct this problem for intenational 
users at this time. There is a program that can be used to evaluate every new 
GEOS installation. But the results are based on a programming error in the 
GEOS KERNAL, and the clock must be set to 60 Hz. 

Before we start debugging, well quickly study how to program the 
real-time clock, as well as look at some routines in the GEOS KERNAL. 



53.1 Programming the clock 



The '64 has two 6526 microchips known as CIA's (for Complex Interface 
Adapters). These chips are used in conjunction with input and output to 
different peripherals O^eyboard, disk drive, joysticks, etc.) and, in addition, 
control a twenty-four hour clock with a progranmiable alarm. 

Of the 16 registers, we'll only discuss those that are relevant to the problem 
with the clock. The register numbers are related to the first memory 
locations for the different CIA's. 
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The time register 

There are four registers that can be controlled to work with the actual time, 
in BOD format: 



All registers can be read or written to. While reading the data from a clock 
register, the time cannot be updated. This means that the 1/lOth second 
register is frozen. (The clock itself continues to run). 

When writing to the clock registers, the clock stops just long enough for the 
1/lOth second register to be set, and to check the synchronization. 



The control register ($0E) 

Only two bits are needed to control the clock. These are the last two bits of 
the CIA register. 

Bit 7 determines if your clock is running properly. If you are running at 50 
Hz, then this bit must always be set to 1. 

By solving this problem, we have actually taken ourselves further away 
from solving the second problem. The second control bit, which can be 
found in the same position in register $0F, determines if a subsequent write 
operations uses the normal clock or the alarm clock (bit 7 = 1). 

The same memory register is used for setting both clock time and alarm 
time, as well as for reading the clock. This is the reason why you can*t reset 
the alarm clock. 

(You could solve this problem by setting the alarm time input in another 
memory register.) 



Rggistgrff 



Cpntgnts 



$08 
$09 
$0A 
$0B 



Seconds 
Minutes 
Hours 



1/lOth seconds 
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Alarm output 

To keep the actual time in synch with the time in the alarm clock, you must 
also correctly handle register $0D (the Interrupt Control Register, or ICR). 

GEOS automatically sets bit 2 of this register whenever the alarm is set. 
This bit is inspected every cycle. Then alarm is eventually sounded when 
the interval has expired. This byte is cleared after every read to ensure that 
every set alarm will be sounded. For more information on the CIA, see The 
Anatomy of the Commodore 64 , Chapter 8. 



53.2. The routines in GEOS 



To adjust the time and alarm there is a program on the GEOS diskette that is 
called ALARM CLOCK. You can use the program to set important dates. For 
this to work continually, the KERNAL routines must check the cycles. If an 
alarm is set for a specific time, then an audio/visual alarm is sounded. 

The date calculation routines are related to the real-time clock. If youVe 
ever left your computer running overnight, you know the Preference 
Manager automatically updates the new calendar date. 

If the date is February 28th of a leap year, GEOS also handles this 
correctly. Both the clock routine and die date calculation routine work 
together. The date routine is accessed from the KERNAL at $C2C8. 

If you use a disk monitor, then you can see what we are talking about. 
Youll find the date and alarm routines in the $C2C8 region. Other routines 
that GEOS uses in normal operations during each cycle are located in 
$C2D1 through $C2D4. Following these are routines for the mouse. 

Both of these subroutines are documented. The first is in RAM at $F390. 
The second can be found after $F9ED. 
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Time and Date Routines 



^ Q O 


ao 


01 




Ida 


$01 


save old memory configurations 


Q o O 


A O 






pna 






r l700 


ay 


OO 




Ida 


•tf- ^ Q c 


turn on I/O region 


r yoo 


Q c: 


n 1 
Ul 




Sua 


9OI 




■p Q "a T 


1 Q 

/o 






sei 






■P Q Q O 


ad 


dc 


f\ -P 

Or 


Ida 


^ ^ .Mi A -C 

?dcOr 


switch alarm input to time input 


t yoJD 


zy 


•7 -P 




and 


4t tf! "7 -P 




•P Q 

r you 


O <J 

oCL 


ac 


f\ -P 
Of 


sta 


?dcOr 




■P Q /I r» 

r y 4U 


aci 


ly 


o c 
00 


Ida 


$8oiy 


contents of hours in hex-format 














( 0— z4nr} 


■P Q /I Q 


cy 


oc 




cmp 


■U. ^ A ^ 

#90C 


is it after noon? 


■P Q A c; 


oU 


o 




bmi 


6 -P Q ^ "P 

9r y 4r 


no : continue 


•P Q ^ 

r y 4 / 




Ot> 


dc 


Dlt 


5dcOb 


is the pm flag set? 


r y fia 


oU 


Oo 




bmi 


6 -P Q / -P 

9r y 41 


yes : continue 


r y fic 




A 


■P Q 

I y 


jsr 


6 -p ^ 
9! yo4 


otherwise : set date and new day 


■P Q /I -P 

r y fir 


acL 


OD 


dc 


Ida 


$dcOD 


get hours 


•PQ C\0 

r yoz 


y 


1 -P 

ir 




and 


f 9ir 


Clear pm riag 


■PQ ^ A 

r y Oft 


cy 






cmp 


iF«?l-i. 


compare with 12 hour clock 


■PQ R 

r y o D 




uz 




bne 


^ -P Q -a 

9! yoa 


unequal: continue 




ai^ 


u u 




±aa 


•fryUU 


otherwise : set back to 


•PQ 

r y oa 


Or* 


UD 


dc 


01c 




am/pm test 


•PQ CL/^ 

r y DO. 


1 n 
lU 


UO 




Dpi 


6 -P Q C /I 

y b4 


am: continue 


"FQ R-P 


r o 






sed 






■P Q c 

r y bu 








clc 






•P Q CI 

t y bi 


by 


Iz 




adc 


41. ^ "1 

#$lz 


add 12 for 24nr clock 


■P Q C3 

r y bo 


^ Q 
UO 






cid 






•P Q C ^ 

r y 64 


20 


ay 


f 9 


jsr 


(f« £ A J A 

$r yd9 


change hours (BCD) in hexadecimal 


•PQ C7 

I y D / 


Q/-1 


1 y 


oO 


Sua 


9ooiy 


and store 


•FQ 

X !7 oa 


au. 


ua 


ac 


±aa 


•?acua 


get. minuL.es 


-P Q 

r y ba 


zU 


ay 


-P Q 

I y 


jsr 


6 -P Q 

9t ydy 


change to hex 


•P 0*7 fi 

r y / u 


oCl 


la 


oO 


sta 


9o0ia 


and store 


r 973 


ad 


09 


dc 


Ida 


$dc09 


get seconds 


f976 


20 


d9 


f9 


jsr 


$f9d9 


change to hex 


f979 


8d 


lb 


85 


sta 


$851b 


and store 


f97c 


ad 


08 


dc 


Ida 


$dc08 


get 1/lOth seconds 


f97f 


68 






pla 




restore old memory configuration 


f980 


85 


01 




sta 


$01 




f982 


58 






cli 






f983 


60 






rts 
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calculate day 

f984 20 b4 f9 jsr $f9b4 put number of days in this month 

into accumulator 
f987 cd 18 85 cmp $8518 and compare with today's date 
f98a fO 04 beq $f990 same: add one to month 
f98c ee 18 85 inc $8518 otherwise: only increment day 
f98f 60 rts 

★★★★★★★★★★★★★★★★★★★★★★★★calculate month and year 

f990 a9 01 Ida #$01 first day of the month 

f992 8d 18 85 sta $8518 

f995 ee 17 85 inc $8517 increment month 

f998 ad 17 85 Ida $8517 

f99b c9 Od cmp #$0d end of the year? 
f 99d dO 14 bne $f9b3 not yet, continue 
f99f a9 01 Ida #$01 otherwise: january 
f9al 8d 17 85 sta $8517 
f9a4 ee 16 85 inc $8516 increment year 
f9a7 ad 16 85 Ida $8516 

f9aa c9 64 cmp #$64 end of the century? 
f9ac dO 05 bne $f9b3 no: continue 
f9ae a9 00 Ida #$00 otherwise: year = 
f9b0 8d 16 85 sta $8516 
f9b3 60 rts 

★★★★★★★★★★★★★★★★★★★★★★★★★★★get number of days this 
★★★★★★★★★★★★★★★★★★★★★★★★★★★month, so far 



f9b4 


ac 


17 


85 


Idy 


$8517 


contents of actual month 


f9b7 


88 






dey 






f9b8 


b9 


cd 


f9 


Ida 


$f9cd,y 


get nijinber of days from table 


f9bb 


48 






pha 




save 


f9bc 


cO 


01 




cpy 


#$01 


february (decrement by 1) 


f9be 


dO 


Ob 




bne 


$f9cb 


no: continue 


f9c0 


ad 


16 


85 


Ida 


$8516 


otherwise: get year 


f9c3 


29 


03 




and 


#$03 


test for leap year 


f9c5 


dO 


04 




bne 


$f9cb 


not leap year: continue 


f9c7 


68 






pla 




otherwise: forget value 


f9c8 


a9 


Id 




Ida 


#$ld 


new value =29 


f9ca 


60 






rts 






f9cb 


68 






pla 






f 9cc 


60 






rts 






f9cd 


If 






??? 






f 9ce 


Ic 






??? 
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f9cf 


If 






??? 






f9d0 


le 


If 


le 


asl 


$lelf, 


X 


f9d3 


If 






??? 






f9d4 


If 






777 






f9d5 


le 


If 


le 


asl 


$lelf. 


X 


f9d8 


If 






777 






************************ 




f 9d9 


48 






pha 




save Dv^jj vaxue 


i. y\jLci 




•pn 
J. \j 




o m 


If V J- v 


y^eu j.ei.t.iuosu nj.jjjj±e 


f9dc 


4a 






Isr 




CillvJL X^OUClU6 UNJ J.JL^ilL. 


f9dd 


4a 






Isr 






f9de 


4a 






Isr 






f9df 


4a 






Isr 






f9e0 


aa 






tax 




marK nuniDer 


f9el 


68 






pla 




g^eu ov^jj numoer 


f9e2 


29 


Of 




and 


#$ Of 


cxear ^eru naxi. 


f9e4 


18 






clc 




and add X times 10 


f9e5 


ca 






dex 






f 9e6 


30 


04 




bmi 


$f9ec 




f9e8 


69 


Oa 




adc 


#$0a 




f9ea 


dO 


f9 




bne 


$f9e5 




f 9ec 


60 






rts 







Here are some things to look for in the listing: 

The real-time clock uses the first CIA port location, located at $DCOO. At 
the same time GEOS keeps its time in normal memory in hexadecimal 
format, and uses these routines to convert back and forth. This results in the 
following rules (the 1/lOth second location is not used): 

$8519 Hours 
$851 A Minutes 
$85 IB Seconds 

Since there is no register in the CIA for the date, it is found in RAM, and is 
taken directly from memory: 

$8516 Year 
$8517 Month 
$8518 Day 
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★ * Ala nil output 



f 9ed 


a5 


01 




Ida 


SOI 




±. ^ d J- 


4R 












f 9f 
J 1. \j 


a9 

Cl ^ 






1 da 


If 




f 9f 2 




01 




O U Cl 


V v J. 




f 9f 4 


ad 


Od 


Ac 


Ida 




vJt5 U clJ.CiJLlll 5(»aL>Uo 


f 9f 7 


8S 


04 










f 9f 9 


68 






Dla 






f 9f a 


85 


01 




st a 


301 

V V A 




f 9fc 


a5 


04 




Ida 


$04 

V V/ T 


AlaTTTi ^t*at"nQ 


f 9fe 


2c 


Ic 


85 


bit 


$851c 

V V ^ J. W 


T ^ an a 1 a ym ^ t Tno «ot**? ^V^it* '7=1 \ 


faOl 


10 


18 




bpl 


$f alb 


NO • Pont" i mi^ 


fa03 


29 


04 




and 


#$04 


Is alarm set to qo*^ 


fa05 


f 


Ic 




b©q 


$f a23 


NO: Finished 


fa07 


a9 


4a 




Ida 


#$4a 


YES : Get value for 10 beens 


fa09 


8d 


Ic 


85 


sta 


$851c 


(set bit 7 to 0. the alann 














will be handled. ) 


f aOc 


a9 


00 




Ida 


#$00 


Test addresses S84ad/$84ae 














for a nob 


f aOe 


cd 


ad 


84 


citip 


$84ad 




fall 


\JL\J 


OS 






$f al8 

V JL d X V/ 




f al3 


cd 


a^ 


84 




$84ae 




fal6 


fO 


03 




beq 


$falb 


No alarm job/ output 














normal GEOS beep. 


fal8 


6c 


ad 


84 


jmp 


($84ad) 


otherwise jump to job 


falb 


2c 


Ic 


85 


sta 


$851c 


All beeps done? 


fale 


50 


03 




bvc 


$fa23 


YES: Continue 


fa20 


20 


24 


fa 


jsr 


$fa24 


NO: Take care of beeps 


fa23 


60 












******************** Output alarm sounds 


fa24 


ad 


lb 


88 


Ida 


$881b 


Wait for system IRQ until 














decremented to 


fa27 


dO 


2a 




bne 


$fa53 


not 0: Perhaps next time 


fa29 


a5 


01 




Ida 


$01 


Save old memory configuration 


fa2b 


48 






pha 






fa2c 


a9 


35 




Ida 


#$35 


Blend in I/O region 


fa2e 


85 


01 




sta 


$01 




fa30 


a2 


18 




Idx 


#$18 




fa32 


bd 


54 


fa 


Ida 


$fa54,x 


Sound device with date 


fa35 


9d 


00 


d4 


sta 


$d400,x 


is retrieved from table 



*** (sounds now) 
fa38 ca dex 
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fa39 


10 


f 7 




bpl 


$fa32 




f a3b 


a2 


21 




Idx 


#$21 




f a3d 


ad 


Ic 


85 


Ida 


$851c 




f a40 


29 


3f 




and 


#$3f 




fa42 


dO 


01 




bne 


$fa45 






aa 






tax 




Accumulator = 0:turn off alarm 


f a45 


8e 


04 


d4 


stx 


$d404 


Control register is set to voice 


f a48 


68 






pla 




Restore old memory configuration 


fa49 


85 


01 




sta 


$01 




fa4b 


a9 


le 




Ida 


#$le 


Set a new value for the interval 
pause 


fa4d 


8d 


lb 


88 


sta 


$881b 




fa50 


ce 


Ic 


85 


dec 


$851c 


Decrement number of beeps 


fa53 


60 






rts 







Things to look for in the listing: 

Youll notice when evaluating the date that two memory locations are 
switched. However, the function of these locations is not specified in the 
listing: 

1. The status register - $851C 

Whenever you set a time for the ALARM CLOCK, you also set the 7-bit at 
this address. This is the basis for the decision whetihier or not an alarm has 
been set in the previous code (see $F9FE). If an alarm has been entered, 
and bit 2 of the ICR ($DCOD) is set, then the status register is loaded with 
the value #$4A. As long as bit 6 is set, then $FA20 in the alarm sound 
generator is started. This subroutine gets the values for the sound generator 
output from a table, located at $D400, then starts producing sound while 
any of the bits through 5 are set ($FA3B - $FA45). The data for the sound 
generator is chosen to produce a short tone that dies off quickly. 

Finally, the beep counter in $FA50 is decremented by 1. 

2. The interval register - $881B 

At first glance, it is difficult to determine the purpose of this location. It is 
accessed by the IRQ rountine (Interupt Request), which is activated when a 
signal is detected on one of the lines. The main GEOS loop is halted just 
long enough to check the keyboard input, read the joystick port, perform 
input and output. 
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In the area $E321, this location $881B is decremented by one: 



$E321 


LDX 


$881B 


$E324 


BEQ 


$E32A 


$E326 


DEX 




$E327 


STX 


$881B 


$E32A 







After the IRQ is complete, the computer returns to the interrupt routine so 
that the program can continue to run — ^at least until the next time an interrupt 
request comes along. 

If you look refer to the sound output subroutine again, you will understand 
the purpose of the region at $FA24. Location $88 IB determines the pause 
between the beeps. If this register is not cleared, a beep is not sounded and 
the "Beep-Counter" is not decremented. When it is set back to zero by the 
interrupt routine, the next sound is produced. At $FA4B a new starting 
value representing the pause interval is placed in the register. 
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5.33 The time at a glance 



Isn't it annoying to have to load the Preference Manager or ALARM CLOCK 
to sneak a quick look at the clock? 

If you think so too, here's a program that constantly displays the time (in 
24-hour format) in the upper left comer of the screen. 

We have also made a change to the alarm output routine. The alarm signal 
itself is a sound from the computer and a quick flash on the monitor. 

There was one problem with implementing this program: there is no room in 
memory for the program! GEOS does not leave any spare memory. 

However, we found an area in the KERN AL that we could use without 
locking up the system. This means that we can use the routines with which 
you are ahready familiar. We can handle all of the hours in the day fairly 
easily. However, the hour we have to pay attention to is midnight. At 
midnight we have to change the date, as well as the time. However, we 
made the asssumption that most people who use GEOS will not use the 
program at that time of night. Therefore, it was easier to just eliminate this 
exception. 

As you can see, we can handle every hour of the day in the same manner — 
we don't have to look at every hour to change the date. 

The program is loaded into memory starting at $7090. The first part of the 
program is a window that asks whether or not you want to constantly 
display the time. Depending on your answer, it will either load the old or the 
new routine into the KERN AL. 
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Figure 74: Constant display clock with window 



If you only need to see the clock once or twice using the Preference 
Manager, then simply answer no to the question. If this is the case, the 
original KERNAL clock routine is copied into memory. 

Our program is divided into three parts: 

1) The graphic output area for the time display. 

2) The date change from the original program. 

3) The window with the Yes or No question. 

In the short term there is enough room in the normal program memory for 
both time routines. However, once you load a program like geoPaint, then 
that region is no longer available. The program is overwritten the moment 
you try to draw a circle. 

Now here is the program. You can enter the program directly into memory 
starting at $7090 with an assembler, then save the memory area directly to 
diskette. For those of you who don't have an assembler, we have listed the 
program in DATA statements as a BASIC program, which writes the 
program directly to diskette. 
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In both cases you will have to convert the program into GEOS format. To 
do this, load the FILEMASTER program, and perform the following steps: 

1) Fkst create an icon (Command CSP). You can also use an 
existing icon (SPL), and can even modify the icon if you wish. 

2) Read the file (Command RFL). 

3) Enter the date with the DATE command. 

4) Convert the program using gees. Answer the question about 
file type with a 5 (=DESK ACCESORY). 

5) Now read in the info box with INFO and give it the following 
addresses: 

START ADDRESS : 28816 

( 2 88 14 if entered with a monitor) 
END ADDRESS : 2 9504 
INITIALIZATION: 28816 

When you are finished with the conversion and have typed end, nothing 
more is needed. 



5200 


78 






SEX 




Initialization 


5201 


A2 


00 




LDX 


#$00 


Save $02-$05 for stack 


5203 


B5 


02 




LDA 


$02, X 


(needed for initialization) 


5205 


48 






PHA 






5206 


E8 






INX 






5207 


EO 


04 




CPX 


#$04 




5209 


DO 


F8 




BNE 


$5203 




520B 


A2 


91 




LDX 


#$91 


Put window parameters in 


52 OD 


AO 


52 




LDY 


#$52 


$5219 


520F 


86 


02 




STX 


$02 




5211 


84 


03 




STY 


$03 




5213 


A9 


2C 




LDA 


#$2C 




5215 


8D 


CD 


Fl 


STA 


$F1CD 




5218 


8D 


2F 


F3 


STA 


$F32F 




521B 


20 


56 


C2 


JSR 


$C256 


Show window 


52 IE 


A9 


20 




LDA 


#$20 




5220 


8D 


CD 


Fl 


STA 


$F1CD 




5223 


8D 


2F 


F3 


STA 


$F32F 




5226 


A5 


02 




LDA 


$02 


Value from YES /NO boxes 


5228 


C9 


04 




CMP 


#$04 


NO box clicked? 


522A 


FO 


06 




BEQ 


$5232 


Copy old job to operating sys 


522C 


A2 


B4 




LDX 


#$B4 


Starting addr. of new routine 
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522E 


AO 


53 


LDY 


#$53 




5230 


DO 


04 


BNE 


$5236 


Jump to copy routine 


5232 


A2 


DO 


LDX 


#$D0 


Start addr. of old routine 


5234 


AO 


52 


LDY 


#$52 




5236 


86 


02 


STX 


$02 




5238 


84 


03 


STY 


$03 




523A 


A2 


38 


LDX 


#$38 


Starting address in 


523C 


AO 


F9 


LDY 


#$F9 


Kernal: $F938 


523E 


86 


04 


STX 


$04 




5240 


84 


05 


STY 


$05 




5242 


AO 


00 


LDY 


#$00 


Counter 


5244 


Bl 


02 


LDA 


($02), Y 


Get byte 


5246 


91 


04 


STA 


($04), Y 


and put in operating system 


5248 


C8 




INY 






5249 


CO 


AE 


CPY 


#$AE 


174 bytes copied? 


524B 


DO 


F7 


BNE 


$5244 


NO — continue copying 


52 4D 


A2 


7E 


LDX 


#$7E 


Starting address of new 


524F 


AO 


53 


LDY 


#$53 


alarm output routine 


5251 


86 


02 


STX 


$02 




5253 


84 


03 


STY 


$03 




5255 


A2 


ED 


LDX 


#$ED 


Destination address in 


5257 


AO 


F9 


LDY 


#$F9 


Kernal: $F9ED 


5259 


86 


04 


STX 


$04 




525B 


84 


05 


STY 


$05 




52 5D 


AO 


00 


LDY 


#$00 




525F 


Bl 


02 


LDA 


($02), Y 


Get byte and put 


5261 


91 


04 


STA 


($04), Y 


in operating system 


5263 


C8 




INY 






5264 


CO 


36 


CPY 


#$36 


54 bytes copied? 


5266 


DO 


F7 


BNE 


$525F 


NO — continue copying 


5268 


A2 


00 


LDX 


#$00 


Re-establish zero page 


52 6A 


AO 


61 


LDY 


#$61 




52 6C 


86 


04 


STX 


$04 




52 6E 


84 


05 


STY 


$05 




5270 


AO 


3F 


LDY 


#$3F 




5272 


A9 


55 


LDA 


#$55 




5274 


91 


04 


STA 


($04), Y 




5276 


88 




DEY 






5277 


A9 


AA 


LDA 


#$AA 




5279 


91 


04 


STA 


($04), Y 




527B 


88 




DEY 






527C 


10 


F4 


BPL 


$5272 




527E 


A2 


03 


LDX 


#$03 
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5280 


68 






PLA 




5281 


95 


02 




STA 


$02, X 


5283 


CA 






DEX 




5284 


10 


FA 




BPL 


$5280 


5286 


A2 


3E 




LDX 


#$3E 


5288 


AO 


C2 




LDY 


#$C2 


52 8A 


8E 


9B 


84 


STX 


$849B 


528D 


8C 


9C 


84 


STY 


$849C 


5290 


60 






RTS 





★★★★★★★★★★★★★★★★★★★★★★★★window parameter table (see chap. 6) 



5291 


81 


OB 


25 


lA 


A3 


52 


OB 


25 




5299 


23 


BA 


52 


03 


04 


40 


04 


OE 




52A1 


40 


00 


44 


4F 


20 


59 


4F 


55 


DO YOU 


52A9 


20 


57 


49 


53 


48 


20 


54 


4F 


WISH TO 


52B1 


20 


53 


45 


45 


20 


54 


48 


45 


SEE THE 


52B9 


00 


43 


4C 


4F 


43 


4B 


20 


18 


CLOCK 


52C1 


50 


45 


52 


4D 


41 


4E 


45 


4E 


PERMANEN 


52C9 


54 


4C 


59 


20 


IB 


3F 


00 


AD 


TLY ? 


52D1 


OF 


DC 


29 


7F 


8D 


OF 


DC 


AD 




52D9 


19 


85 


C9 


OC 


30 


08 


2C 


OB 




52E1 


DC 


30 


03 


20 


84 


F9 


AD 


OB 




52E9 


DC 


29 


IF 


C9 


12 


DO 


02 


A9 




52F1 


00 


2C 


OB 


DC 


10 


05 


F8 


18 




52F9 


69 


12 


D8 


20 


D9 


F9 


8D 


19 




5301 


85 


AD 


OA 


DC 


20 


D9 


F9 


8D 




5309 


lA 


85 


AD 


09 


DC 


20 


D9 


F9 




5311 


8D 


IB 


85 


AD 


08 


DC 


68 


85 




5319 


01 


58 


60 


20 


B4 


F9 


CD 


18 




5321 


85 


FO 


04 


EE 


18 


85 


60 


A9 




5329 


01 


8D 


18 


85 


EE 


17 


85 


AD 




5331 


17 


85 


C9 


OD 


DO 


14 


A9 


01 




5339 


8D 


17 


85 


EE 


16 


85 


AD 


16 




5341 


85 


C9 


64 


DO 


05 


A9 


00 


8D 




5349 


16 


85 


60 


AC 


17 


85 


88 


B9 




5351 


CD 


F9 


48 


CO 


01 


DO 


OB 


AD 




5359 


16 


85 


29 


03 


DO 


04 


68 


A9 




5361 


ID 


60 


68 


60 


IF 


IC 


IF 


IE 




5369 


IF 


IE 


IF 


IF 


IF 


IF 


IE 


IF 




5371 


48 


29 


FO 


4A 


4A 


4A 


4A 


BA 




5379 


68 


29 


OF 


18 


CA 


A4 


01 


A9 





191 



Abacus Software 



GEOS Inside and Out 



★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★New alarm output (see 3.2) 



Do / tt 




U 1 




T T^V 


6 A 1 
$01 


Save old memory configuration 


O U 


A Q 

Ay 


OD 




T T^TV 


ir9oD 


I/O register on 




oD 


U J. 




O 1 A 






OOO ft 


AD 


1 r* 


oD 


T 1^ TV 






OOO / 


1 n 


1 o 




DOT 




Get alarm clock status 


Q Q 


T\T^ 

AU 


UD 


DC 


T TV 

liDA 


9DCOD 


Don't test new alarm 




z y 


U *t 




TVXTr\ 

AMJJ 


A^f\A 


Alarm occurred? 




r U 








9D0BI 


NO — cont inue 


on 




ZU 


p^n 
u\) 


T rvTV 
LDA 


$DUzU 


Save old border colors 


DO y o 


Qn 


DJd 


TP TV 

r A 


bxA 


^"CTV Co 

$FAdB 


(free area) 


Doy b 


T\ Q 

Ay 


A T\ 

4A 




T TV 

LDA 


#94A 


Value for 10 beeps 


Doy o 


oD 




Q R 
OD 


o m TV 
5TA 


6 c 1 
$ODiC 




DO yjD 


uy 






CMlr 


if 


Last beep sounded? 


DO yjj 




U / 




BN£ 


6 R Q TV C 

9D0A0 


NO — cont inue 


Doyr 


7VT? 

Ahi 


Do 


r A 


T FW 

LDa 


^TTITV Cn 

9£ ADB 


Else get old color 


DoiiZ 


UA 






DCjA 




Decrement by one 


R Q TV Q 


qt? 

OCi 




DU 


r» m V 

STX 


A A 


and set colors 


53A6 


2C 


IC 


85 


BIT 


$851C 


All beeps finished? 


53A9 


50 


06 




BVC 


$53B1 


YES — ready 


5 SAB 


EE 


20 


DO 


INC 


$D020 


Otherwise change colors and 


53AE 


20 


24 


FA 


JSR 


$FA24 


sound beep 


53B1 


84 


01 




STY 


$01 


Set old memory configuration 


53B3 


60 






RTS 






*******************************jjew time routine 


53B4 


CE 


D5 


F9 


DEC 


$F9D5 


Counter (time actualized 
every 16 times) 


53B7 


FO 


05 




BEQ 


$53BE 


ZerOf then output 


53B9 


68 






PLA 




Otherwise return 


53BA 


85 


01 




STA 


$01 




53BC 


58 






CLI 






53BD 


60 






RTS 






53BE 


A2 


00 




LDX 


#$00 


Save $02-$05 for stack 


53C0 


B5 


02 




LDA 


$02, X 


(time is in $06-$0d in 


53C2 


48 






PHA 




HH:MM:SS format) 


53C3 


E8 






INX 






53C4 


EO 


OC 




CPX 


#$0C 




53C6 


DO 


F8 




BNE 


$53C0 




53C8 


A9 


3A 




LDA 


#$3A 


Screen POKE for colons 


53CA 


85 


08 




STA 


$08 


between hrs . & mins . , 


53CC 


85 


OB 




STA 


$0B 


and mins . & sees . 


53CE 


AD 


OB 


DC 


LDA 


$DCOB 


Hour register 


53D1 


29 


7F 




AND 


#$7F 
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53D3 


20 


C3 


F9 


JSR 


$F9C3 


Convert hours to 2 POKES 


53D6 


86 


06 




STX 


$06 


and place in hours position 


53D8 


85 


07 




STA 


$07 




5 3D A 


AD 


OA 


DC 


LDA 


$DC0A 


Get minutes 


53DD 


20 


C3 


F9 


JSR 


$F9C3 


Convert to 2 POKES 


53E0 


86 


09 




STX 


$09 


and store them 


53E2 


85 


OA 




STA 


$0A 




53E4 


AD 


09 


DC 


LDA 


$DC09 


Get seconds 


53E7 


20 


C3 


F9 


JSR 


$F9C3 


Convert to 2 POKES 


53EA 


86 


OC 




STX 


$0C 


and store them 


53EC 


85 


OD 




STA 


$0D 




53EE 


AD 


08 


DC 


LDA 


$DC08 


Read 1/10 seconds for clock 


****************************** 


*Output POKES to bitmap 


53F1 


A9 


31 




LDA 


#$31 


Character set on 


53F3 


85 


01 




STA 


$01 




53F5 


A2 


38 




LDX 


#$38 


$A138 is the topmost address 
of second block 


53F7 


AO 


Al 




LDY 


#$A1 




53F9 


86 


04 




STX 


$04 


Set up as bitmap pointer 


53FB 


84 


05 




STY 


$05 




53FD 


A2 


07 




LDX 


#$07 


Pointer for SS:MM:HH 


53FF 


A9 


00 




LDA 


#$00 


Delete high byte of char, sel 
pointer 


5401 


85 


03 




STA 


$03 




5403 


B5 


06 




LDA 


$06, X 


Get POKE from table (seconds 


5405 


OA 






ASL 




first) /compute char. set addr 


5406 


26 


03 




ROL 


$03 




5408 


OA 






ASL 






5409 


26 


03 




ROL 


$03 




540B 


OA 






ASL 






540C 


26 


03 




ROL 


$03 




540E 


85 


02 




STA 


$02 


Low byte 


5410 


A9 


DO 




LDA 


#$D0 


Add start addr. of char, set 
($D000) 


5412 


18 






CLC 






5413 


65 


03 




ADC 


$03 




5415 


85 


03 




STA 


$03 




5417 


AO 


07 




LDY 


#$07 




5419 


Bl 


02 




LDA 


($02), Y 


Get line from char, set 


541B 


91 


04 




STA 


($04) ,Y 


and put into bitmap 


541D 


88 






DEY 




All 8 lines ready? 


541E 


10 


F9 




BPL 


$5419 


NO — then output next line 


5420 


A5 


04 




LDA 


$04 


Otherwise, compute starting 
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5422 


38 




SEC 




addr. in next block of bitmap 


5423 


E9 


08 


SBC 


#$08 




5425 


85 


04 


STA 


$04 


Low byte 


5427 


A5 


05 


LDA 


$05 




5429 


E9 


00 


SBC 


#$00 


Eventual overflow 


542B 


85 


05 


STA 


$05 


High byte 


542D 


CA 




DEX 




All 8 characters output? 


542E 


10 


CF 


BPL 


$53FF 


NO — output more characters 


5430 


A2 


OC 


LDX 


#$0C 


Else restore zero page 


5432 


68 




PLA 






5433 


95 


01 


STA 


$01^X 




5435 


CA 




DEX 






5436 


10 


FA 


BPL 


$5432 




5438 


A9 


10 


LDA 


#$10 


New start value for counter 


543A 


8D 


D5 F9 


STA 


$F9D5 




543D 


58 




CLI 






543E 


60 




RTS 








^Convert hex byte to 












2 screen POKES 


543F 


48 




PHA 




Save 


5440 


29 


FO 


AND 


#$F0 


left half 


5442 


4A 




LSR 




Move to right nybble 


5443 


4A 




LSR 






5444 


4A 




LSR 






5445 


4A 




LSR 






5446 


18 




CLC 






5447 


69 


30 


ADC 


#$30 


Add offset to POKE 


5449 


AA 




TAX 




in X-register 


544A 


68 




PLA 




Get value 


544B 


29 


OF 


AND 


#$0F 


of right half 


544D 


18 




CLC 






544E 


69 


30 


ADC 


#$30 


Add offset to POKE 


5450 


60 




RTS 







Here is the same program in the form of DATA lines for BASIC. Save this 
program on a diskette using the desired filename, then perform the same 
conversion steps as listed before to convert the program to GEOS format 
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rent ««3ic!ic««$3|ci|c»]|c««««««3i[«}ic$««««««$$«}|c«}ic 

1 rem * this program creates a -file, * 

2 rem * which must be converted to * 

3 rem * the geos— format by using the * 

4 rem * "^=i le-master " . * 

5 rem * load address = dec (20992) * 

6 rem « entry point = dec (20992) « 

7 rem * end address = dec (21600) * 

8 rem * -file type = 5 (accessory)* 

14 restore: print chr*(147); 

15 input" CD0WN3program name";f* 
20 open 1 ,8,2, f *+" ,p, w" 

30 -for i=6 to 592 

35 read a: print#l , chr* (a) 5 s b=b+a 
40 next 
45 close! 

50 i-f b<>61424 then print "error in data!" 

100 end 

101 datal20, 162,0, 181,2,72,232,224,4,208,248, 162, 1 
45, 160,82, 134,2, 132,3, 169 

102 data44, 141 , 205, 241 , 141 , 47, 243, 32, 86, 194, 169,32 
, 141,205,241, 141,47,243 

103 datal65, 2, 201, 4,240,6, 162, 180, 160,83,208,4, 162 
, 208, 160, 82, 134, 2, 132, 3 

104 datal62,56, 160,249, 134,4, 132,5, 160,0, 177,2, 145 
, 4, 200, 192, 174, 208, 247 

105 datal62, 126, 160,83, 134,2, 132,3, 162,237, 160,249 
, 134,4, 132,5, 160,0, 177 

106 data2, 145,4,200, 192,54,208,247, 162, O, 160,97, 13 
4,4, 132,5, 160,63, 169,85 

107 datal45,4, 136, 169, 170, 145,4, 136, 16,244, 162,3, 1 
04, 149,2,202, 16,250, 162 

108 data62, 160, 194, 142, 155, 132, 140, 156, 132,96, 129, 
11,37,26, 163,82, 11,37,35 

109 datal86,32,3,4,64,4, 14,64,0,68,79,32,39,79,85, 
32, 87, 73, 83, 72, 32, 84, 79 

110 data32, S3, 69, 69, 32, 84, 72, 69, 0,67, 76, 79, 67, 75, 3 
2, 24, SO, 69, 82, 77, 65, 78 

111 data69,7S,S4,76,89,32,27,63,0, 173, 15,220,41, 12 
7, 141, 15,220, 173,25, 133 

112 data201, 12,48,8,44, 11,220,48,3,32, 132,249, 173, 
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11,220,41,31,201, 18,208 

113 data2, 169,0,44, 11,220, 16,5,248,24, 105, 18,216,3 
2,217,249, 141,25, 133, 173 

114 datal0,220,32,217,249, 141,26, 133, 173,9,220,32, 
217,249, 141,27, 133, 173 

115 dataS,220, 104, 133, 1 , 88, 96, 32, 180,249,205,24, 13 
3,240,4,238,24, 133,96, 169 

116 datal, 141,24, 133,238,23, 133, 173,23, 133,201, 13, 
208,20, 169, 1, 141,23, 133 

117 data238,22, 133, 173,22, 133, 201 , 100, 208, 5, 169,0, 
141,22, 133,96, 172,23, 133 

118 datal36, 185,205,249,72, 192, 1 , 208, 1 1 , 173, 22, 133 
,41,3,208,4,104,169,29 

119 data96, 104,96,31,28,31,30,31,30,31,31,31,31,30 
, 31 , 72, 41 , 240, 74, 74, 74 

120 data74, 186, 104, 41 , 15, 24, 202, 164, 1 , 169, 53, 133, 1 
, 173,28, 133, 16, 18, 173, 13 

121 data220,41,4,240,33, 173,32,208, 141,91,250, 169, 
74,141,28,133,201,64,208 

122 data7, 174,91,250,202, 142,32,208,44,28, 133,80,6 
,238,32,208,32,36,250,132 

123 datal , 96, 206, 213, 249, 240, 5, 104, 133, 1 , 88, 96, 162 
,0, 181,2,72,232,224, 12 

124 data208,24S, 169,58, 133,8, 133,11,173,11,220,41, 
127,32, 195,249, 134,6, 133 

125 data7, 173, 10,220,32, 195,249, 134,9, 133, 10, 173,9 
,220,32,195,249,134,12 

126 datal33, 13, 173,8,220, 169,49, 133, 1 , 162, 56, 160, 1 
61, 134,4, 132,5, 162,7, 169 

127 dataO, 133,3, 181,6, 10,38,3, 10,38,3, 10,38,3, 133, 
2,169,208,24,101,3,133 

128 data3, 160,7, 177,2, 145,4, 136, 16,249, 165,4,56,23 
3,8, 133,4, 165,5,233,0, 133 

129 data5,202, 16,207, 162, 12, 104, 149, 1,202, 16,250, 1 
69,16,141,213,249,88,96 

130 data72,41,240,74,74,74,74,24, 105,48, 170, 104,41 
,15,24,105,48,96 
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53.4 The foreign aberration in the GEOS KERNAL 



WeVe found a problem in using GEOS with 50 Hz electrical current. If 
youVe using the U.S. standard of 60 Hz current, you can skip this section. 

We discovered this problem while working on the clock program in the 
previous sections. We changed the 50/60 Hz control register for the clock 
with the help of the single step simulator (which we will discuss in the next 
chapter). With this we have written two subroutines which work during the 
initialization of GEOS (each time it is started up, for example with RESET). 
The first routine is located at $CFA1, and gets the correct time using the 
standard of the video signals (PAL for example: SECAM) and places it in 
the control register $DCOE. 

The clock will work just as well in Europe as it does in the U.S., just as 
long as the frequency is set properly. This is where the GEOS operating 
system problem occurs. It constantly uses location $CD6B as the jumping 
point to routines. Each time this occurs the machine writes the value for 60 
Hz from a table into the control register. The problem is that this has simply 
been ignored in GEOS. 

Apparently the developers of GEOS didn't notice this problem, since all of 
their machines were running at 60 Hz. However, if you want to display the 
correct time on a European GEOS, you can perform the following steps: 
After booting GEOS, go into BASIC, then enter the command poke 
53132 , 128 and then start over again with the conmiand SYS 522 98. 

This procedure must be followed before every application that uses the 
clock. However, this can be very time-consuming — especially changing all 
of the system diskettes. Therefore, we have written a BASIC program that 
searches the table in the KERNAL and writes the appropriate value for 50 
Hz to the control register. 

This is not an actual fix of the GEOS KERNAL, since the output of the 
video standard is always ignored. However, it's a Quick-n-Dirty fix that 
displays the correct time when you need it. 

Warning : Don't try to run the program discussed unless you read the 
following information. It's possible that you'll lose all of your data. Before 
you start the program, exit GEOS and make an additional backup copy on a 
completely blank diskette. This program only works with the European 
version of GEOS. 
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Enter only the BASIC program. Make sure that your backup copy — ^not the 
original GEOS diskette — is in the disk drive. Then start the program. 

The computer searches for the correct location on the diskette, and notifies 
you if a change is made to the diskette. During this procedure, the computer 
displays the number of blocks searched. 

If the program cannot find the correct location, there are a few possible 
reasons: 

1) The program was entered incorrectly (check the program again, or 

even have a second person proof read the program for you). 

2) The diskette is not correct. 

3) The copy of the lOERNAL is corrupted. (Try making another copy 
on a different diskette.) 

4) There is a hardware problem. (The read/write head could be out of 
alignment.) 

If the program did run correctly, you can copy the results back to the 
original diskette. 

Note: Before you perform any of the following operations, try running the 
altered version of GEOS to make sure that everything is working properly. 

Get the original diskette and remove the write-protect tab. Now boot up 
your machine with the new (changed) copy of GEOS. Now, using FILE 
INFO, remove the file protection from the program GEOS KERNAL and 
move it to the waste basket. (Did you make a backup copy, just in case?). 

Finally, copy the altered KERNAL to the original diskette. Once the 
program is copied, retum the file protection to this file. 

Here's a listing of the program: 
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10 PRINT CHR$(147)/: REM CLR HOME 

15 OPEN 1,8,15^"!": GOSUB 100 

20 OPEN 2^ 8, 2, "GEOS KERNAL" : GOSUB 100 

25 GET #2,A$,A$,T$,S$:GOSUB100 .-CLOSE 2 

30 OPEN 3^8^3,"#l":GOSUB 100 

35 PRINT#1,"U1:"3;0;ASC(T$) ;ASC(S$) 

40 PRINT CHR$ (19) ;B:B=B+1:REM BLOCK COUNTER 

45 PRINT#1,"B-P:"3;0 

50 GET#3,T$,S$:S$=S$+CHR$(0) 

55 RESTORE 

60 READ D:IF K=254 THEN K=0:GOTO 35 
65 GET#3,A$:A=ASC(A$+CHR$(0)) :K=K+1 
70 IF AOD THEN I=0:GOTO 55 
75 1=1+1: IF I<4 THEN 60 
80 PRINT#3,CHR$(128) 

85 PRINT#1,"M-W"CHR$(1) ;CHR$(0) ;CHR$(1) ; CHR$(144) 
90 CLOSEl 

100 INPUT#1,A,B$:IF A THEN PRINTB$:STOP 
105 RETURN 

110 DATA 13,220,3,127:REM COMPARISON VALUES 

If this program's operation interests you, here's a brief description: 
Line Function 

25 Get first track / sector of the KERNAL (A$ is ignored). 

30 Open data channel. 

35 Read a sector into the channel. 

45 Set pointer to byte in channel. 

50 Get next sector and track numbers. 

60 Get comparison byte out of DATA statement. Read all 

bytes from the sector, then get new sector. 
65 Get value from channel: increment byte counter. 
70 Compare the byte with DATA; if unequal, then no bytes 

are correct : get the next byte from the channel. 
75 Otherwise increment the counter. Continue if there are 

more bytes . 

80 Write the value for 50 Hz to the correct location. 
85 Call the routine Block Write. 
100 Read from the error channel if there were any errors. 
Output any which might have occurred. 
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Inside GEOS 



In this chapter well present information you need to write your own GEOS 
applications. For instance, well tell you how to access GEOS routines for 
your own purposes. We'll begin with an important GEOS tool. 



6.1 The single-step simulator 



We developed a single-step simulator for investigating the GEOS operating 
system. This simulator makes it possible to follow the operation of the 
microprocessor very closely. 

Within the simulator, a branch is made to a routine after each machine 
language instruction, which displays the current contents of the processor 
registers at the bottom of the screen and waits until a key is pressed. Then it 
retums to the main program. At the same time, the current contents of any 
four memory locations can also be displayed. We used this tool primarily 
for tracing important subroutines in the KERNAL (window routines, alarm 
evaluation, etc.). 

The code for the SST (Single STep simulator) can be entered directly into 
memory at $7090 with a monitor, and then saved from there to diskette. The 
program is then converted to an executable GEOS accessory with 
FILEMASTER. You should note the following points about the conversion: 

1) First create a suitable icon (sprite) for the SST — it's command 
se in the FILEMASTER program. You can also read in an 
existing icon and modify it (command spl). 

2) Read the SST (conmiand rf 1). 

3) Enter the current date with DATE. 

4) Convert SST with GEOS. Answer the file type question with 5 
(=desk accessory). 

5) Read the info box and enter the following decimal addresses: 
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START ADDRESS : 28816 (28814 if entered with a 

monitor) 

END ADDRESS : 2 9504 
INITIALIZATION : 28816 



Before completing the conversion process with END, enter any information 
in the info box (author name, date, etc.). Now the SST is on the diskette 
as a GEOS accessory, and can be loaded and started by clicking. 

Here is the documented listing of the SST: 

★★★★★★★★★★★Initialization 



7090 


78 






SEX 






7091 


A2 


05 




LDX 


#$05 


Copy program to $4590 


7093 


AO 


90 




LDY 


#$90 




7095 


B9 


00 


70 


LDA 


$7000, Y 




7098 


99 


00 


45 


STA 


$4500, Y 




709B 


C8 






INY 






709C 


DO 


F7 




BNE 


$7095 




709E 


EE 


97 


70 


INC 


$7097 


Increment source addr. high byte 


70A1 


EE 


9A 


70 


INC 


$709A 


Increment dest. addr. high byte 


70A4 


CA 






DEX 




Everything copied? 


7 OAS 


DO 


EE 




BNE 


$7095 


NO — Continue 


70A7 


A2 


02 




LDX 


#$02 


Call alarm output w/NOPs ($EA) 


70A9 


A9 


EA 




LDA 


#$EA 


Written (read location from 


70AB 


9D 


D4 


C2 


STA 


$C2D4,X 


$DDOD, to see what our routine 


70AE 


CA 






DEX 




has stopped) 


7 OAF 


10 


FA 




BPL 


$70AB 




70B1 


4C 


B4 


45 


JMP 


$45B4 


Jump to copy of this program 


70B4 


A5 


01 




LDA 


$01 


Save old memory configuration 


70B6 


48 






PHA 






70B7 


A9 


35 




LDA 


#$35 


Switch on I/O registers 


70B9 


85 


01 




STA 


$01 




70BB 


AE 


FE 


FF 


LDX 


$FFFE 


Get original GEOS interrupt 


70BE 


AC 


FF 


FF 


LDY 


$FFFF 


address 


70C1 


8E 


F4 


47 


STX 


$47F4 


and restore 


70C4 


8C 


F5 


47 


STY 


$47F5 




70C7 


A2 


06 




LDX 


#$06 


New IRQ address: $4606 


70C9 


AO 


46 




LDY 


#$46 




70CB 


8E 


FE 


FF 


STX 


$FFFE 




70CE 


8C 


FF 


FF 


STY 


$FFFF 




70D1 


AD 


OE 


DC 


LDA 


$DC0E 


Stop timer 
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70D4 


29 


FE 




AND 


#$FE 




70D6 


8D 


OE 


DC 


STA 


$DCOE 




70D9 


AD 


OD 


DC 


LDA 


$DCOD 


Delete IRQ control register 


70DC 


A9 


7F 




LDA 


#$7F 


Delete mask 


7 ODE 


8D 


OD 


DC 


STA 


$DCOD 




70E1 


A9 


81 




LDA 


#$81 


New IRQ: Timer A underrun 


70E3 


8D 


OD 


DC 


STA 


$DCOD 




70E6 


A2 


17 




LDX 


#$17 


Time in cycles / after start of 


70E8 


AO 


00 




LDY 


#$00 


timer^ until IRQ occurs 


70EA 


8E 


04 


DC 


STX 


$DC04 




70ED 


8C 


05 


DC 


STY 


$DC05 




70F0 


AD 


OE 


DC 


LDA 


$DCOE 


Start timer (single sub-counte: 


70F3 


09 


09 




ORA 


#$09 




70F5 


8D 


OE 


DC 


STA 


$DCOE 




70F8 


68 






PLA 




Establish old memory 
configuration 


70F9 


85 


01 




STA 


$01 




70FB 


A2 


3E 




LDX 


#$3E 


Rewrite swap file; RESET 


70FD 


AO 


C2 




LDY 


#$C2 




70FF 


8E 


9B 


84 


STX 


$849B 




7102 


8C 


9C 


84 


STY 


$849C 




7105 


60 






RTS 






★★★★★★★★★★★★★★★★★★★★★★★★★★★★New IRQ starting address 


7106 


8D 


EF 


47 


STA 


$47EF 


Get accumulator 


7109 


68 






PLA 




Get status reg. in accumulator 


710A 


48 






PHA 






710B 


8D 


F3 


47 


STA 


$47F3 


and mark it 


710E 


A5 


01 




LDA 


$01 


Save old memory configuration 


7110 


8D 


EE 


47 


STA 


$47EB 




7113 


A9 


35 




LDA 


#$35 


I/O registers on 


7115 


85 


01 




STA 


$01 




7117 


A9 


01 




LDA 


#$01 


IRQ source output 


7119 


2D 


19 


DO 


AND 


$D019 


through raster lines? 


711C 


2D 


lA 


DO 


AND 


$D01A 




711F 


FO 


03 




BEQ 


$7124 


NO — Execute SST interrupt 


7121 


4C 


CB 


47 


JMP 


$47CB 


Else prepare system in- 
terrupt from GEOS 


★★★★★★★★★★★★★★★★★★★★★★★★ ★★★★SST interrupt 


7124 


A9 


FD 




LDA 


#$FD 


Test for <SHIFT> key 


7126 


8D 


00 


DC 


STA 


$DCOO 




7129 


AD 


01 


DC 


LDA 


$DC01 




712C 


30 


14 




BMI 


$7142 


Not pressed? — Continue 


712E 


AD 


OD 


DC 


LDA 


$DCOD 


Else do shortened interrupt 
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7131 


AD 


OE 


DC 


LDA 


$DCOE 


Re-start timer 


7134 


09 


09 




ORA 


#$09 




7136 


8D 


OE 


DC 


STA 


$DCOE 




7139 


AD 


EB 


47 


LDA 


$47EB 


Re-establish old memory 
configuration 


713C 


85 


01 




STA 


$01 




713E 


AD 


EF 


47 


LDA 


$47EF 


Get acciimulator 


7141 


40 






RTI 




Return from interrupt 


7142 


A9 


7F 




LDA 


#$7F 


Test <C=> key 


7144 


8D 


00 


DC 


STA 


$DCOO 




7147 


AD 


01 


DC 


LDA 


$DC01 




714A 


CD 


01 


DC 


CMP 


$DC01 




714D 


DO 


F8 




BNE 


$7147 




714F 


29 


20 




AND 


#$20 




7151 


FO 


07 




BEQ 


$715A 


Pressed? Execute single-step 


7153 


A9 


FF 




LDA 


#$FF 


Else cancel repeat function 


7155 


8D 


EC 


47 


STA 


$47EC 




7158 


DO 


CA 




BNE 


$7124 


Absolute jump to wait loop 


715A 


8E 


FO 


47 


STX 


$47F0 


Save X-register 


715D 


8C 


Fl 


47 


STY 


$47F1 


Save Y-register 


7160 


BA 






TSX 






7161 


E8 






INX 




Correct stack 


7162 


E8 






INX 






7163 


E8 






INX 






7164 


8E 


F2 


47 


STX 


$47F2 


and save it 


7167 


68 






PLA 






7168 


68 






PLA 




Save program counter 


7169 


8D 


EE 


47 


STA 


$47EE 


low byte 


716C 


68 






PLA 




Save program counter 


716D 


48 






PHA 






716E 


8D 


ED 


47 


STA 


$47ED 


high byte 


7171 


AD 


EE 


47 


LDA 


$47EE 


Return low byte to stack 


7174 


48 






PHA 






7175 


AD 


F3 


47 


LDA 


$47F3 


Return status to stack 


7178 


48 






PHA 






7179 


A2 


00 




LDX 


#$00 




717B 


AD 


ED 


47 


LDA 


$47ED 


Convert program counter high 


717E 


20 


6F 


47 


JSR 


$476F 


byte to 2 POKES and place in 


7181 


8D 


15 


48 


STA 


$4815 


table 


7184 


8C 


16 


48 


STY 


$4816 




7187 


AO 


00 




LDY 


#$00 




7189 


B9 


EE 


47 


LDA 


$47EE,Y 


Get remaining registers 


718C 


8C 


ED 


47 


STY 


$47ED 


Save register pointer; 
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718F 


20 


6F 


47 


JSR 


$476F 


7192 


9D 


17 


48 


STA 


$4817, 


7195 


E8 






INX 




7196 


98 






TYA 




7197 


9D 


17 


48 


STA 


$4817, 


719A 


AC 


ED 


47 


LDY 


$47ED 


719D 


E8 






INX 




719E 


E8 






INX 




719F 


C8 






INY 




71A0 


CO 


06 




cpy 


#$06 


71A2 


DO 


E5 




BNE 


$7189 


71A4 


A2 


07 




LDX 


#$07 


71A6 


AD 


F3 


47 


LDA 


$47F3 


71A9 


48 






PHA 




71AA 


4E 


F3 


47 


LSR 


$47F3 


7 IAD 


BO 


03 




BCS 


$71B2 


71AF 


A9 


2E 




LDA 


#$2E 


71B1 


• byte 


2C 






71B2 


A9 


IE 




LDA 


#$1E 


71B4 


9D 


26 


48 


STA 


$4826, 


71B7 


CA 






DEX 




71B8 


10 


FO 




BPL 


$71AA 


71BA 


AD 


07 


85 


LDA 


$8507 


71BD 


20 


6F 


47 


JSR 


$476F 


7 ICO 


8D 


2F 


48 


STA 


$482F 


71C3 


8C 


30 


48 


STY 


$4830 


71C6 


AD 


B6 


84 


LDA 


$84B6 


71C9 


20 


6F 


47 


JSR 


$476F 


7 ICC 


8D 


32 


48 


STA 


$4832 


71CF 


8C 


33 


48 


STY 


$4833 


71D2 


AD 


06 


85 


LDA 


$8506 


71D5 


20 


6F 


47 


JSR 


$476F 


71D8 


8D 


10 


48 


STA 


$4810 


71DB 


8C 


11 


48 


STY 


$4811 


7 IDE 


AD 


OE 


DC 


LDA 


$DCOE 


71E1 


20 


6F 


47 


JSR 


$476F 


71E4 


8D 


13 


48 


STA 


$4813 


71E7 


8C 


14 


48 


STY 


$4814 


71EA 


68 






PLA 




71EB 


8D 


F3 


47 


STA 


$47F3 



Convert to 2 pokes 
Left POKE value 



Right POKE value 
Get register pointer 
Increment table pointer 

Increment register pointer 

All registers converted to POKES 

NO — Continue 

Output status register 

Move respective bit into carry 

If setf then arrow 

Else enter POKE value for point 

after; enter an 

$LDA #$1E in table 



Get more status flags 
1st selectable memory location 
displayed (hereimouse speed) 
Value in lower left of line 

2nd selectable memory location 
(hereiborder contact of mouse) 
Display follows in lower right 
of line 

3rd selectable memory location 
(here: joystick value) 
Display in upper left 

4th selectable memory location 
(here:50/60Hz clock register) 



Reset status 
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★★★★★★★★★★★★★★★★★★★★★★******Display register contents 



71EE 


A2 


05 




LDX 


#$05 


Save $07-$02 for stack 


71F0 


B5 


02 




LDA 


$02, X 




71F2 


48 






PHA 




$02/$03=address in character ROM 


71F3 


CA 






DEX 




$04/$05 of address in bitmap 


71F4 


10 


FA 




BPL 


$71F0 


$06/$07=pointer from POKE table 


71F6 


A9 


BD 




LDA 


#$BD 


Address in bitmap 


71F8 


85 


05 




STA 


$05 


Upper line of message 


71FA 


A9 


BO 




LDA 


#$B0 




71FC 


85 


04 




STA 


$04 




71FE 


A9 


F6 




LDA 


#$F6 




7200 


85 


06 




STA 


$06 




7202 


A9 


47 




LDA 


#$47 




7204 


85 


07 




STA 


$07 




7206 


20 


8B 


47 


JSR 


$478B 


Output upper line 


7209 


A9 


BE 




LDA 


#$BE 


Address in bitmap 


720B 


85 


05 




STA 


$05 


Lower line of message 


720D 


A9 


FO 




LDA 


#$F0 




720F 


85 


04 




STA 


$04 




7211 


A9 


15 




LDA 


#$15 


Register table address 


7213 


85 


06 




STA 


$06 




7215 


A9 


48 




LDA 


#$48 




7217 


85 


07 




STA 


$07 




7219 


20 


8B 


47 


JSR 


$478B 


Output lower line 


721C 


A2 


00 




LDX 


#$00 


Re-establish zero page 


721E 


68 






PLA 




(stack $02-$07) 


721F 


95 


02 




STA 


$02, X 




7221 


E8 






INX 






7222 


EO 


06 




CPX 


#$06 




7224 


DO 


F8 




BNE 


$721E 




7226 


AD 


EC 


47 


LDA 


$47EC 


Delay function active? 


7229 


FO 


IB 




BEQ 


$7246 


YES — exit interrupt 


722B 


A9 


7F 




LDA 


#$7F 


Else test <C=> key 


722D 


8D 


00 


DC 


STA 


$DCOO 




7230 


A2 


80 




LDX 


#$80 


Repeat function timeloop value 


7232 


AD 


01 


DC 


LDA 


$DC01 




7235 


CD 


01 


DC 


CMP 


$DC01 




7238 


DO 


F8 




BNE 


$7232 




723A 


29 


20 




AND 


#$20 




723C 


DO 


08 




BNE 


$7246 


No longer pressed? 


723E 


CE 


EC 


47 


DEC 


$47EC 


Decrement repeat counter 


7241 


DO 


EF 




BNE 


$7232 




7243 


CA 






DEX 




Time running? 



208 



Abacus Software 



GEOS Inside and Out 



7244 


DO 


EC 




BNE 


$7232 


NO — Continue testing 


7246 


A9 


01 




LDA 


#$01 


Delete IRQ directions from GEOS 


7248 


8D 


19 


DO 


STA 


$D019 




724B 


AD 


OD 


DC 


LDA 


$DCOD 


Exit only on random IRQ 


724E 


A2 


01 




LDX 


#$01 




7250 


AO 


00 




LDY 


#$00 




7252 


88 






DEY 






7253 


DO 


FD 




BNE 


$7252 




7255 


CA 






DEX 






7256 


DO 


FA 




BNE 


$7252 




7258 


AD 


OE 


DC 


LDA 


$DCOE 


Start timer 


725B 


09 


09 




ORA 


#$09 




725D 


8D 


OE 


DC 


STA 


$DCOE 


Now timer runs in cycles 


7260 


AD 


EB 


47 


LDA 


$47EB 


4 cycles 


7263 


85 


01 




STA 


$01 


3 


7265 


AE 


FO 


47 


LDX 


$47F0 


4 


7268 


AC 


Fl 


47 


LDY 


$47F1 


4 


726B 


AD 


EF 


47 


LDA 


$47EF 


4 


726E 


40 






RTI 




6 


★★★★★★★★★★★★★★★★★★★★★★★★★★★★Convert hex number to 2 POKES 


726F 


48 






PHA 






7270 


20 


7D 


47 


JSR 


$477D 


Convert right nybble to POKE 


7273 


A8 






TAY 




Put into Y-register 


7274 


68 






PLA 






7275 


4A 






LSR 






7276 


4A 






LSR 






7277 


4A 






LSR 






7278 


4A 






LSR 






7279 


20 


7D 


47 


JSR 


$477D 


Convert left nybble to POKE 


727C 


60 






RTS 






★★★★★★★★★★★★★★★★★★★★★★★★★★★★Convert nybble to screen POKE 


727D 


29 


OF 




AND 


#$0F 




727F 


D8 






CLD 






7280 


38 






SEC 






7281 


E9 


OA 




SBC 


#$0A 




7283 


BO 


02 




BCS 


$7287 


Greater than 9 (add a 1) 


7285 


69 


39 




ADC 


#$39 


Else add offset to corresponding 


7287 


18 






CLC 




POKE (-1) 


7288 


69 


01 




ADC 


#$01 




728A 


60 






RTS 
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****************************output in the bitmap 



728B 
728D 
728F 
7291 
7293 

7295 
7297 
7298 
729A 
729B 
72 9D 
729E 
72A0 
72A2 
72A4 
72A5 
72A7 
72A9 
72AA 
72AB 
72AD 
72AF 
72B1 
72B2 
72B4 
72B5 
72B6 
72B7 
72B9 
72BB 
72BD 
72BF 
72C1 
72C3 
72C4 
72C6 
72C8 
72CA 



A9 
85 
AO 
A9 
85 

Bl 
OA 
26 
OA 
26 
OA 
26 
85 
A9 
18 
65 
85 
98 
48 
AO 
Bl 
91 
88 
10 
68 
A8 
38 
A5 
E9 
85 
A5 
E9 
85 
88 
10 
A9 
85 
60 



33 
01 
IE 
00 
03 

06 

03 

03 

03 
02 
DO 

03 
03 



07 
02 
04 

F9 



04 
08 
04 
05 
00 
05 

CB 
35 
01 



LDA #$33 
STA $01 
LDY #$1E 
LDA #$00 
STA $03 



LDA 
ASL 
ROL 
ASL 
ROL 
ASL 
ROL 
STA 
LDA 
CLC 
ADC 
STA 
TYA 
PHA 
LDY 
LDA 
STA 
DEY 
BPL 
PLA 
TAY 
SEC 
LDA 
SBC 
STA 
LDA 
SBC 



($06), Y 

$03 

$03 

$03 
$02 
#$D0 

$03 
$03 



#$07 
($02), Y 
($04), Y 

$72AD 



Put in character set 

Initialize character counter 

High-byte of char, set pointer 
address 

Get screen POKE from table; 
compute address in character set 



Low byte 

Starting address is 
as offset 



$D000; add 



Save character counter 

(Y-register needed) 

Write 8 lines of one character 



All lines? 

NO — Continue getting 
character counter 

Compute next position in 
the bitmap 



$04 
#$08 
$04 
$05 
#$00 
STA $05 
DEY 

BPL $7291 
LDA #$35 
STA $01 
RTS 

****************************prepare normal GEOS 

72CB AD OD DC LDA $DCOD Clear ICR 

72CE A9 7F LDA #$7F Reset IRQ condition 



Eventual overflow 

More characters? 
Then output them 
Else re-call I/O 



Ready 



range 



IRQ 
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72D0 


8D 


OD 


DC 


STA 


$DCOD 




72D3 


A9 


81 




LDA 


#$81 


Under- running timer A runs IRQ 


72D5 


8D 


OD 


DC 


STA 


$DCOD 




72D8 


AD 


OE 


DC 


LDA 


$DCOE 


Start timer 


72DB 


09 


09 




ORA 


#$09 




72DD 


8D 


OE 


DC 


STA 


$DC0E 




72E0 


AD 


EB 


47 


LDA 


$47EB 


Establish old memory configure 


72E3 


85 


01 




STA 


$01 




72E5 


AD 


EF 


47 


LDA 


$47EF 




72E8 


6C 


F4 


47 


JMP 


($47F4) 


to original GEOS interrupt 



72EB 


00 


00 


00 


00 


00 


00 


00 


00 


72F3 


00 


00 


00 


20 


10 


03 


20 


20 


72FB 


01 


03 


20 


18 


12 


20 


19 


12 


7303 


20 


13 


10 


20 


OE 


16 


23 


02 


730B 


04 


09 


lA 


03 


20 


20 


20 


20 


7313 


20 


20 


20 


20 


20 


20 


20 


20 


731B 


20 


20 


20 


20 


20 


20 


20 


20 


7323 


20 


20 


20 


20 


20 


20 


20 


20 


732B 


20 


20 


20 


20 


20 


20 


20 


20 


7333 


20 


00 


00 


00 


00 


00 


00 


00 


733B 


00 


00 


00 


00 


00 









Register contents (to $72F5) 
POKE value descriptions 
($72F6-$7315) 



Register POKES ($7316-) 



Next, the BASIC loader of the SST. 

rem ttttttttttttttttttttttttttttttttt 

1 rem * this program creates a -file, * 

2 rem * which must be converted to * 

3 rem * the geos— format by using the * 

4 rem * "file-master". * 

5 rem t load address = dec (28816) * 

6 rem * entry point = ""( ) « 

7 rem * end address = dec (29504) * 

8 rem * -file type = 5 (accessory)* 

9 rem ********************************* 

14 restoresprint chr* ( 147) 3 s rem clr home 

15 input " CDOWNlprogram name";-f* 
20 open 1 , 8, 2, -f *+" , p , w" 

30 -for i=0 to 687 

35 read a: pr int#l , chr* (a) ; s b=b+a 
40 next 
45 close 1 

50 i-f b<>74293 then print "error in data!" 
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9000 data 120,162,5,160,144,185,0,112 

9001 data 153,0,69,200,208,247,238,151 

9002 data 112,238,154,112,202,208,238,162 

9003 data 2,169,234,157,212,194,202,16 

9004 data 250,76,180,69,165,1,72,169 

9005 data 53,133,1,174,254,255,172,255 

9006 data 255,142,244,71,140,245,71,162 

9007 data 6,160,70,142,254,255,140,255 

9008 data 255,173,14,220,41,254,141,14 

9009 data 220,173,13,220,169,127,141,13 

9010 data 220,169,129,141,13,220,162,23 

9011 data 160,0,142,4,220,140,5,220 

9012 data 173,14,220,9,9,141,14,220 

9013 data 104,133,1,162,62,160,194,142 

9014 data 155,132,140,156,132,96,141,239 

9015 data 71,104,72,141,243,71,165,1 

9016 data 141,235,71,169,53,133,1,169 

9017 data 1,45,25,208,45,26,208,240 

9018 data 3,76,203,71,169,253,141,0 

9019 data 220,173,1,220,48,20.173.13 

9020 data 220,173,14,220,9,9,141,14 

9021 data 220,173,235,71,133,1,173,239 

9022 data 71,64,169,127,141,0,220,173 

9023 data 1,220,205,1,220,208,248,41 

9024 data 32,240,7,169,255,141,236,71 

9025 data 208,202,142,240,71,140,241,71 

9026 data 186,232,232,232,142,242,71,104 

9027 data 104,141,238,71,104,72,141,237 

9028 data 71,173,238,71,72,173,243,71 

9029 data 72,162,0,173,237,71,32,111 

9030 data 71,141,21,72,140,22,72,160 

9031 data 0,185,238,71,140,237,71,32 

9032 data 111,71,157,23,72,232,152,157 

9033 data 23,72,172,237,71,232,232,200 

9034 data 192,6,208,229,162,7,173,243 

9035 data 71,72,78,243,71,176,3,169 

9036 data 46,44,169,30,157,38,72,202 

9037 data 16,240,173,7,133,32,111,71 

9038 data 141,47,72,140,48,72,173,182 

9039 data 132,32,111,71,141,50,72,140 

9040 data 51,72,173,6,133,32,111,71 

9041 data 141,16,72,140,17,72,173,14 

9042 data 220,32,111,71,141,19,72,140 
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9043 data 20,72,104,141,243,71,162,5 

9044 data 181,2,72,202,16,250,169,189 

9045 data 133,5,169,176,133,4,169,246 

9046 data 133,6,169,71,133,7,32,139 

9047 data 71,169,190,133,5,169,240,133 

9048 data 4,169,21,133,6,169,72,133 

9049 data 7,32,139,71,162,0,104,149 

9050 data 2,232,224,6,208,248,173,236 

9051 data 71,240,27,169,127,141,0,220 

9052 data 162,128,173,1,220,205^,220 

9053 data 208,248,41,32,208,8,206,236 

9054 data 71, 208 , 239 , 202 , 208 , 236 , 1 69 , 1 

9055 data 141 , 25, 208, 173, 13, 220, 162, 1 

9056 data 160,0,136,208,253,202^208^250 

9057 data 173,14,220,9,9,141,14,220 

9058 data 173,235,71,133,1,174,240,71 

9059 data 172,241,71,173,239,71,64,72 

9060 data 32,125,71,168,104,74,74,74 

9061 data 74,32,125,71,96,41,15,216 

9062 data 56,233,10,176,2,105,57,24 

9063 data 105,1,96,169,51,133,1,160 

9064 data 30,169,0,133,3,177,6,10 

9065 data 38,3,10,38,3,10,38,3 

9066 data 133, 2, 169, 208, 24, 101 , 3, 133 

9067 data 3,152,72,160,7,177,2,145 

9068 data 4,136,16,249,104,168,56,165 

9069 data 4,233,8,133,4,165,5,233 

9070 data 0,133,5,136,16,203,169,53 

9071 data 133,1,96,173,13,220,169,127 

9072 data 141,13,220,169,129,141,13,220 

9073 data 173,14,220,9,9,141,14,220 

9074 data 173,235,71,133,1,173,239,71 

9075 data 108,244,71,0,0,0,0,0 

9076 data 0,0,0,0,0,0,32,16 

9077 data 3,32,32,1,3,32,24,18 

9078 data 32,25,18,32,19,16,32,14 

9079 data 22,35,2,4,9,26,3,32 

9080 data 32,32,32,32,32,32,32,32 

9081 data 32,32,32,32,32,32,32,32 

9082 data 32,32,32,32,32,32,32,32 

9083 data 32,32,32,32,32,32,32,32 

9084 data 32,32,32,32,0,0,0,0 

9085 data 0,0,0,0,6,0,0,0 
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Now a few remarks about the operation of the program. 

In the initialization, the SST automatically copies itself to memory at $4950. 
It is not possible to load directly to this address because under GEOS, the 
area in which a program is loaded is recorded on tiie diskette. The operating 
system writes the resulting file (SWAP file) at this location after the end of 
the program. Since we want to exit our program without having it 
overwritten by the SWAP file, we copy it to an area that will not be 
overwritten. The computer can crash when the single-step simulator is 
loaded if actions are performed which require a large amount of memory 
(such as drawing a filled circle in geoPaint). Because of the limited memory 
space, this could not be done differently. 

The actual operating principle is based on the interrupt technique. A timer in 
the Coniplex Interface Adapter (CIA), located at $DC(X), is programmed in 
the initialization such that the microprocessor can execute only one 
instruction in the main program before it it interrupted and a branch is made 
to an SST routine, which is located at $7 IOC. 

Here we have to evaluate the cause of the interrupt because GEOS also 
works with program interruptions in order to read the keyboard or joystick. 
This is done at $71 ID, where the Interrupt Control Register of the video 
chip is read. GEOS does not create the system interrupt through a timer 
(jiffy clock) as in the original '64 operating system, but by evaluating the 
raster line in which the electron beam of the monitor is scanned. The video 
chip can generate an IRQ every time a given line of the screen is written. 
The system IRQ is given priority in the SST so that inputs can be made via 
the keyboard or joystick. 

If no requests are made through GEOS, the new routine at $712A is 
processed. If the Commodore (C=) key is pressed, the current register 
contents are fetched from the stack and converted to codes which can be 
accessed easily from the old '64 character set (screen codes). The output is 
displayed using the high-resolution graphics of GEOS, first the top line 
witii the titles, and then the register contents. The timer is started again at 
$725E after the output and control returns to the interrupted program. 

To initialize GEOS properly, run another GEOS accessory before running 
SST. Then under the geos menu click the item single-step. After 
loading, it may seem that the computer has crashed, because no mouse 
movements are possible. This is not the case. The computer is just waiting 
for you to press the Conmiodore (C=) key. 
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The following picture will result: 




Figure 75: The Stepper 



A two-line message is displayed at the bottom of the screen. The top line 
contains the names of the register of the 6510 microprocessor. PC stands 
for program counter, AC for accumulator, XR and YR for X and Y registers, 
SP for the stack pointers. The flags of the status register are designated as 



follows: 




N 


negative 


V 


overflow 


B 


BCD mode 


# 


unused (always set) 


I 


intoTupt 


Z 


zero 


c 


cany 



The bottom line displays the current register contents following the last 
executed instruction. The output is displayed in hexadecimal, except for the 
status register. For the status register, an arrow represents a set flag and a 
period represents a cleared flag. 
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In addition, the contents of the four memory locations (which you specify 
before the program started) is displayed at $7 ICO in the listing: 8507 
(mouse speed), 84B6 (mouse edge contact), 8506 (joystick value) and 
DCOE (50/60HZ clock register). 

Each time you now press the C= key, the single instruction corresponding 
to the program counter address is executed. Then the display is refreshed. If 
you depress the C= key for more than two seconds, multiple instructions 
are executed, so that you can process more than a single instruction without 
having to release the key. 

You can press the < SHIFr> key to execute the instructions at an even faster 
rate. The <SHIFT LOCK> key can also be used for extended periods of 
time. 

Using the SST, GEOS operates at a much slower rate than normal. 

To better illustrate the operation of the SST, we will look at the area of 
GEOS that evaluates joystick operation. 

Press the C= key until memory location $C2C8 appears on the screen. This 
is the start of the GEOS "job loop" from which all actions in GEOS are 
directed. One of these is the routine to evaluate the joystick operation. Press 
the C= key again and a branch is made to a routine tihat looks as follows: 



E28F 


BIT 


$39 


E291 


BVC 


$E2A2 


E293 


LDA 


#$BF 


E295 


AND 


$39 


E297 


STA 


$39 


E299 


LDA 


$84A5 


E29C 


LDX 


$84A6 


E29F 


JSR 


$C1D8 


E2A2 


LDA 


$39 


E2A4 


AND 


#$20 


E2A6 


BEQ 


$E2B7 


E2A8 


LDA 


#$DF 


E2AA 


AND 


$39 


E2AC 


STA 


$39 


E2AE 


LDA 


$84A1 


E2B1 


LDX 


$84A2 


E2B4 


JSR 


$C1D8 


E2B7 


BIT 


$39 
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E2B9 


BPL 


$E2C7 


E2BB 


JSR 


$E515 


E2BE 


LDA 


$84A3 


E2C1 


LDX 


$84A4 


E2C4 


JDR 


$C1D8 


E2C7 


LDA 


$84B6 


E2CA 


BEQ 


$E2DA 


E2CC 


LDA 


$84A7 


E2CF 


LDX 


$84A8 


E2D2 


JSR 


$C1D8 


E2D5 


LDA 


#$00 


E2D7 


STA 


$84B6 


E2DA 


RTS 





An important memoiy location, $39, is used here. Bits 5-7 of this address 
represent the current joystick status. The system interrupt is responsible for 
its content. 

Follow the program flow with the SST without moving the joystick. The 
routine is processed in large jumps because of branch instructions at $E291, 
$E2A6, and $E2B9. 

The individual bits in memory location $39 have the following meanings: 

Bit 5 = 1 : new status of the fire button (pressed or not pressed) 
Bit 6 = 1 : new position of the stick 
Bit 7 = 1 : fire button is pressed 

If one of these flags is set, it is reset here and an operating system address is 
placed into the accumulator and the X-register from two memory locations 
assigned to this flag. A jump is then made to this address indirectly via 
$C1D8. 

Hold down the C= key until the program counter is at $C2C8 again. 

Try this by holding the joystick in a set position; make the jump to $E28F 
by pressing the C= key. Since the 6th bit is now set, the jump to $E291 is 
not executed and the flag is reset instead. The address of a job to be 
executed will be fetched from $84 A5 and $84A6. The routine at $C1D8 
performs the indirect jump only if one of the values in the accumulator and 
X-register is non-zero. After processing the corresponding program, the 
computer returns to $E2 A2, where it continues with the rest of the test. 
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6.2 Window techniques 

YouVe probably noticed that all of the operating system messages in 
GEOS, such as disk drive error messages, are displayed in their own 
windows known as error boxes* 

You can easily induce an error box by opening the disk drive door and then 
trying to load a program from the GEOS diskette. This produces an error 
box in the center of Sie screen: 




Figure 76: An output window: error box 



Correct the error by closing the door, and click OK. The window disappears 
and the screen contents are the same as before the error box. 

GEOS also uses windows known as dialogue boxes, in which a cursor 
appears, and allows you to enter characters from the keyboard. Select the 
item rename from the disk menu. This will produce the following 
window: 
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Figure 77: Dialogue box 



The name of the current diskette is displayed in the lower section. It can be 
changed from the keyboard. If you change your mind and decide that you 
want to keep the old name, you can terminate the process with cancel, 
even if you have altered the name akeady. 

You can do this only if you have not pressed the <RETURN> key. This 
type of dialogue between the user and computer is used throughout GEOS. 
We have documented this technique so that you can make use of this form 
of communication in your own programs. 
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6.2.1 Characteristics of windows 



In the introduction you learned what windows are and how they can be 
used. This section details the general rules that must be followed when you 
make your own windows. 

The first two examples illustrate that the original contents of the screen (the 
icons of the disk directory) are restored after the window disappears. It 
should become clear to you that the windowing technique consists of 
nothing more than overwriting certain areas in screen memory with the data 
that represent the window. 

This technique erases the '^previous memory contents — and therefore the 
screen contents as well. To be able to reconstruct the screen after the 
window disappears, the original contents must be saved elsewhere. 

In principle there are two ways for the computer to reconstruct the area of 
the screen covered by the window: 

1 . Save a complete copy of the current screen into a protected area 
of memory. 

When the picture is then regenerated, the entire screen copy is 
then copied back in to screen memory. The disadvantage of this 
technique is the excessive memory space required to save the 
copy. 

2. The area that is overwritten by the window in screen memory is 
copied to a protected area before the window is displayed. 

The original picture is then reconstructed with this "patch", 
instead of complete window regeneration: 
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Figure 78: Re-drawing 



You must be able to change the size of the window to fit the task. It 
wouldn't make sense to continuously display the current time in a window 
that takes up half the screen. Nor would it be appropriate to display 
important operating system messages in a tiny window where it would 
hardly be noticed, 

GEOS is extremely flexible in this respect You can use an appropriately 
sized window for all your specific applications. 

In most cases, windows are used to pass information to the user in the form 
of text. Therefore there must be a way to pass text to the program that 
creates the window. In addition, we must specify where within the window 
the text is to appear. This allows you to do things like display very short 
strings in the center of large windows without having to use blank spaces or 
carriage returns to center tihe text. 
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Figure 79: Odd-shaped window 

You can also select the style of text. You can use this feature to make the 
information in your window more concise and clear to the user. 




Figure 80: Different type styles 
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The routine must know where the text is to appear in the window. In 
addition, the length of the text must be checked to ensure that it doesn't spill 
out of the window. 

Look back at the the first error box that you caused to be displayed (click the 
disk icon with the drive door open). The window is bordered on the right 
and the bottom. This border adds depth to the window and sets it out from 
the rest of the screen. We refer to this as a shadowed window. 

When making a window, you must specify either a shadowed or 
shadowless window. You can also select a pattem for the shadow: 




Figure 81: Patterned shadow 



Another parameter specifies the allowed responses. In this example, the 
program waits until you click the OK button. 

Some windows do not allow any fields to be clicked with the mouse — ^for 
example, GEOS system information boxes. You simply press the mouse 
button. 

Still other windows offer you two or three choices: 
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Figure 82: Two-button dialogue box 



This type of window,the dialogue box, allows us to evaluate one of the two 
choices. Clicking the OK button executes a specified procedure, while 
CANCEL closes the window. 

So GEOS provides many of the tools that can help you program windows 
easily. 
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6.2.2 Custom windows in GEOS 



Now well actually see how to make custom windows using the GEOS 
routines and a minimum of progranmiing effort 

1) What routines are availaUe? 

Surprisingly, only one GEOS routine is of interest to us for customizing 
windows. This routine addresses all of the window characteristics 
mentioned in the previous section. The routine is located in KERNAL RAM 
from $F1BB to $F23E. When writing your own routines, it is much wiser 
to use the GEOS KERNAL jump table to address this routine. The routine 
could change in a newer revision but the KERNAL jump table would still 
point to the right routine. The KERNAL jump vector used for the window 
is located at $C256. 

With this single routine, you won't have to be concerned with how to save 
the screen contents before outputting a window. Also, you won't have to be 
concerned with window management 

The only element you have to furnish to run your program is a pointer to a 
table that contains the window specifications. We'll take a closer look at this 
pointer in the next section. 

2) The parameters 

Let's say that you want to display a message in a window. 

To use the window management routine, you have to pass the appropriate 
parameters to GEOS. The following information is required for windowing: 

1. window size (X-direction) 

2. window size (Y-direction) 

3. window position on the screen 

4. parameter for the shadowed window 

5. parameter for the output text 

6. parameter for the data input 

7. exit criteria (OK, CANCEL, etc.) 

Before the window routine is called, the starting address of this table is 
saved in the zero page at $02 and $03. 
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Example: The table of parameters is at $1234* To display the window, 
proceed as follows: 



LDX #$34 low byte of your table 

LDY #$12 high byte of your table 

STX $02 pass the table pointer 

STY $03 to $02 and $03 

JSR $C256 call window routine 



You are responsible for making sure that the table contains valid parameters. 
Now let's take a look at these parameters in more detail. 

3) The job codes 

Job codes are conmiands that direct a GEOS evaluating routine to perform a 
specific action. 

Some of the job codes require additional information. The job codes are 
stored in a table. Any required data is inserted in the table following the job 
code. The end of the table is marked with a zero. 



4) The format of the window 



The first position in the table is a job code that does not require additional 
data. Therefore it is a one-byte conraiand. This job code specifies the 
window format. 



The individual bits have the following significance: 



Bit 7=1: The window has the same format as the operating 
system boxes (error messages, etc.). It is displayed 
on the screen at the same location. 

Bit 7=0: The format and position of the window is selected 
by the user. If this is the case, the following five 
bytes of the table contain the exact specifications. 
Otherwise, these five bytes are omitted and the next 
job code follows immediately. 

Bits 0-4: If all of these bits are equal to zero, no shadow is 
displayed. Other combinations affect the pattem of 
the shadow (32 possible combinations). 
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The following bytes are necessary only if the seventh bit of the job code 
(first byte) is zero. They determine the position (in pixels) of the top and 
bottom borders of the window on the screen: 

Byte 2: top border 
Byte 3: bottom border 

Values may range from to 199. A represents the top edge of 
the screen, and a 199 represents the bottom edge of the screen. 
The value of Byte 3 must always be greater than the value of 
Byte 2. 

Byte 4: left border (low byte) 
Byte 5: left border (high byte) 
Byte 6: right border (low byte) 
Byte 7: right border (high byte) 

Two bytes are required to represent each border position. Values may range 
from to 319. A represents the left edge of the screen. A 319 represents 
the right edge of the screen The value of Bytes 6 and 7 must be greater tfian 
the value of Bytes 4 and 5. 

These parameters determine both the size of the window and its position on 
the screen. 

The following table demonstrates this: 

1st byte: #$01 (non-standard window with solid shadow) 

2nd byte: #$14 (top border) 

3rd byte: #$50 (bottom border) 

4th byte: #$10 (low byte of left border) 

5th byte: #$00 (high byte of left border) 

6th byte: #$28 (low byte of right border) 

6th byte: #$01 (high byte of right border) 

7th byte: #$00 (table terminator) 

This creates a solid shadowed window starting at point (20, 16) extending 
to (80, 296). 
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5) Pure text output 

Job codes $0B and $0C are used to display text (strings). For job code 
$0B, four bytes of data follow: 

1. # pixels from left border to text 

2. # pixels from top window border to text 

3. address of text (low byte) 

4. address of text (high byte) 

Example: 

The text is located at $5678. A value of zero terminates the text string. It is 
to be displayed in a standard window with a shadow. 

The table looks as follows: 

Byte 1: #$81 (standard window with shadow) 

Byte 2: #$0B (job code for text output) 

Byte 3: #$0A (offset from left border) - 10 pixels 

Byte 4: #$10 (offset from top) - 16 pixels 

Byte 5: #$78 (low byte of text address) 

Byte 6: #$56 (high byte of text address) 

Byte 7: #$00 (table terminator) 

Then place the starting address of the table ($5678) in $02/$03, and call the 
window routine at $C256. The following picture results: 
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Figure 83: Custom window 



The second job code $0C differs in that instead of specifying the absolute 
address of the text, you specify a pointer in the zero page that contains the 
actual text address* This involves indirect addressing, only three bytes are 
required (offset from left edge, offset from top, pointer to zero page). 

Example: 

Two different text strings are located in memory at address $1234 and 
$5678, respectively. One of them is to be displayed by means of indirect 
address via $OC/$OD. The following table must be set up to do this: 

Byte 1: #$81 (standard window with shadow) 

Byte 2: #$0C (job code: indirect addressing) 

Byte 3: #$0A (offset from left edge) 

Byte 4: #$0A (offset from right edge) 

Byte 5: #$0C ($OC/$OD is a pointer to the actual 

address of the text) 

Byte 6: #$00 (end of table) 
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Before the window routine is called, the pointer in zero page ($OC/$OD) 
must contain the starting address of the text string. To output the second text 
string, just replace the pointer ($OC/$OD) with Sie location of the new text 
and call the routine again. 

This method allows you to display different texts very quickly using the 
same table and routines in your program. All you have to do is place the 
starting address of the text in the zero page addresses specified in the table. 

6) Keyboard input 

To position a cursor within the window so that the user can enter data from 
the keyboard, use job code $0D. The evaluating routine then expects four 
more bytes of data: 

Bytes 1 and 2: Distance of the cursor from the left and top edges of 
the window. 

Byte 3: Contains a pointer to an address in the zero page which 

contains the start address of a buffer in which the data 
entered will be stored. 

Byte 4: Determines the maximum number of characters that 

can be entered. 

Example: 

Here we*ll create a window that accepts a filename (maximum of eight 
characters) from the keyboard and stores them at $9876. The table is placed 
at $1234. 

You table could then be constructed similarly to this: 

Byte 1: #$81 (standard window) 

Byte 2: #$0D (job code for input) 

Byte 3: #$05 (5 pixels from the left edge) 

Byte 4: #$0A (10 pixels from the top) 

Byte 5: #$0E (buffer pointer at $0E) 

Byte 6: #$08 (maximum input of 8 characters) 

Byte 7: #$00 (end of table) 
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The routine is called the same way as for text output. To display the 
window, proceed as follows: 



LDX #$76 (low byte of buffer) 

LDY #$98 (high byte of buffer) 

STX $0E (pass the buffer pointer) 

STY $0F (to $0E and $0F) 

LDX #$34 (low byte of table) 

LDY #$12 (high byte of table) 

STX $02 (pass the table pointer 

STY $03 to $02 and $03) 

JSR $C256 (call window routine) 



This window can also display a default text string which can then be edited. 
If you don't need this, just set the first value of the buffer to zero before the 
output 

The routine places the text string you entered into the buffer after you press 
the <RETURN> key. 



Format of text strings 

Text strings are composed of the standard Commodore ASCII codes found 
in the *64 User's Guide. The graphics symbols cannot be used. The 
important point is that the text strings must always be terminated with a zero 
byte. With this method, tihe length of the string doesn't need to be stored. 

One special feature is the control codes, which you can use to change the 
appearance of your text. The following table contains the possible values 
and the type styles to which they correspond. These styles can also be 
mixed (such as bold and italics). 



Control code Type style 

$18 bold text 

$19 italics 

$1A outline text 

$1B standard text 



(Note: Values other than those listed here can lead to a system crash!) 
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The exit criteria 

You have no doubt guessed that there are one or more routines in the GEOS 
KERNAL which must be called with appropriate parameters to make the 
window disappear again and restore the previous screen contents. 
Additionally these routines test the joystick to determine if the mouse is over 
the OK or CANCEL when the button is pressed. 

The nice part about it is that GEOS takes care of almost all of the work for 
us, and we don*t have to know more about these routines. 

The GEOS window disappears when a button within that window is clicked 
or when the <RETURN> key is pressed (only during input). 

To add buttons to your own windows (OK, CANCEL, YES, etc.), simply 
expand your window parameter table. To do this you first enter the job code 
for the desired button, followed by two bytes for the location within the 
window where you want it placed. 

Here are the job codes: 

Job code: Button: 



For example, we want to place a cancel button at point 16,64 ($10,$40) 
within our window. We would add the following to our window table: 

Byte 1: #$02 (cancel button) 

Byte 2 : #$02 (place at 2x8 pixels over and 

Byte 3: #$40 #$40 pixels down) 

Note: When placing buttons in windows, the x direction is multiplied by 8. 
We want the button 16 pixels over, so we divide 16 by 8. Therefore, the 
second byte is 2. 

Next well discuss how to read the button that was clicked. 



$01 
$02 
$03 
$04 
$05 



-OK- 

-CANCEL- 



-YES- 
-NO- 



-OPEN- 
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Evaluation of the buttons 

To determine which button was pressed, GEOS uses memory location $02 
in the zero page. After the window disappears, the value found in memory 
location $02 corresponds to the job code of the button pressed. 

Example: 

You have displayed a window that contains the buttons OK, CANCEL, and 
NO. The window disappears after the user clicks the NO button and control 
returns to your program. Memory location $02 now contains the job code 
for NO ($04), and uses this information to perform the corresponding 
program action. 

If you create a dialogue box (input window) that was terminated by the 
<RETURN> key, the code returned is $1B (13 decimal). 
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6.2.3 Three examples from GEOS 



Following are three examples from the GEOS deskTop that illustrate the 
complete process of window operation. We'll use two routines which you 
have encountered already in the introduction. 

The first displays an error message originating from the disk drive 
operation, and the second changes the name of the diskette. This involves 
text display and keyboard input. The third example is a program that 
illustrates some of the window techniques you just learned about. 

If you want to follow us "live" in our invasion of the operating system, go 
back to BASIC through special and load a monitor into the area $6000 
(we assume that you have a monitor, because youVe followed us this far!). 
This overwrites a copy of the bitmap screen. 

GEOS can be reactivated from the monitor or from BASIC by calling the 
routine at $CC4A (decimal 52298). This reloads the deskTop, which 
shortens the initialization time considerably. You can even make changes to 
the KERNAL first and then observe their effects. 

A SAVE operation may not precede the restart, or the disk drive will not 
operate. One small disadvantage of this restart is that the screen and cursor 
colors are changed, unless the computer finds the preferences file on 
diskette. This can be corrected with the Preference Manager, of course. 

Notice: The following listings are from the American GEOS version 1.2. 
Later and European versions may differ. The KERNAL jump table should 
always be correct The actual location of the subroutines may be a few bytes 
off. 

Now on to our first example. 



The disk error evaluatkm routine 

When you look at the area from $1601 to $1640 with the monitor, you will 
discover the following routine: 
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$1601 CPX #$0C 
$1603 BEQ $1640 
$1605 TXA 
$1606 BEQ $1640 
$1608 LDA $1653, X 
$160B STA $0C 
$160D LDA $1660, X 
$1610 STA $0D 
$1612 CPX #$0E 
$1614 BCC $1635 
$1616 LDA #$38 
$1618 STA #$0D 
$161A LDA #$D2 
$161C STA $0C 
$161E TXA 
$161F SEC 
$1620 SBC #$20 
$1622 BMI $1635 
$1624 TAX 
$1625 CPX #$0E 
$1627 BEQ #162B 
$1629 BCS $1635 
$162B LDA $166E,X 
$162E STA $0C 
$1630 LDA $167D,X 
$1633 STA $0D 
$1635 LDA #$16 
$1637 STA $03 
$1639 LDA #$41 
$163B STA $02 
$163D JSR $C256 
$1640 RTS 

This is the ouQ)ut routine for the disk drive error messages. Similar to the 
old C-64 KERNAL, GEOS has a table containing nothing but jump 
commands. In Version 1.2, $C256 jumps to the routine at $F1BB. Future 
versions of GEOS may not locate the window management routine at 
$F1BB, but a jump to $C256 will always have the desired effect— manage a 
window. 

Let's go through the routine step by step. 
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The first action compares the X register of the processor with decimal 12. If 
the two match, the routine is exited inmiediately. As will be shown later, the 
X register contains the number of the current error message. 12 indicates 
that no error occurred, as does a zero, which is tested in the fourth line. 

For other error numbers, a value is fetched from two tables, one at $1653 
and the other at $1660, which is then placed in $0C and $0D. The computer 
gets the address of the message belonging to the error number in the zero 
page. We can already guess that the job code $0C will appear in the 
parameter table for the window. If the error number is less than 14, 
execution passes directly on to the transmission of the table address for the 
parameters at $1635 and the window output. 

For larger error numbers, the address of the message to output is set to 
$38D2. This corresponds to the message "1:24". In addition, the error 
number is compared with 32. If it is smaller, execution continues as above 
at $1635. 

Otherwise a test is made to see if the error number is larger than 45 ($0E 
plus $20). This would display "1:24". 

If the number is between 32 and 45, the addresses in $OC/$OD are taken 
from another table, which lies at $166E or $167D. Shortly before the 
window routine is called, the pointer for the parameter table is placed in 
$02/$03. In this case the parameter table is at $1641 and looks as follows: 



Byte 


1: 


$1641 


#$81 


(job code for standard window) 


Byte 


2: 


$1642 


#$0B 


(job code for text output) 


Byte 


3: 


$1643 


#$10 


(distance from left edge) 


Byte 


4: 


$1644 


#$20 


(distance from top edge) 


Byte 


5: 


$1645 


#$1A 


(low byte of the text address) 


Byte 


6: 


$1646 


#$38 


(high-byte) 


Byte 


7: 


$1647 


#$0B 


(job code for another text output) 


Byte 


8: 


$1648 


#$10 


(distance from left edge) 


Byte 


9: 


$1649 


#$30 


(distance from top edge) 


Byte 


10: 


$164A 


#$35 


(low byte of the second text) 


Byte 


11: 


$164B 


#$38 


(high byte) 


Byte 


12: 


$164C 


#$0C 


(job code for indirect text output) 


Byte 


13: 


$164D 


#$10 


(distance from left edge) 


Byte 


14: 


$164E 


#$40 


(distance from top edge) 
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Byte 15: $164F #$0C (text address is in $OC/$OD) 

Byte 16: $1650 #$01 (display OK button) 

Byte 17: $1651 #$11 (distance from left edge) 

Byte 18: $1652 #$48 (distance from top edge) 

Byte 19: $1653 #$00 (end of table) 

A total of three different text areas are displayed: The first two are addressed 
in the absolute mode, while the third uses indirect addressing. Ther error 
message consists of three lines. 

The job codes $0B display a standard text string which always appears 
(Operation cancelled due to disk error :). The current 
message is displayed with $0C, as we guessed earlier. 

The OK button is positioned in the window so that the program will continue 
after the error is acknowledged. It is not necessary to read memory location 
$02 here because there is oiJy one button can be pressed. 

When an error occurs, the error number is placed in the X-register and the 
routine above is called. It then outputs the corresponding message and 
retums to the calling routine after the OK button is clicked. 

We now come to our second example. 



The Raiame routine 

It's possible to rename the current work diskette from the deskTop. We 
have documented the Rename routine to illustrate inputting text from a 
window. 

The operation of this routine closely resembles the operation of the first 
example. It simply contains a few more commands to organize text input: 
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$0D43 


LDA 


#$4A 


(the current clisk name is at ^*±Ay\j) 


$0D45 


STA 




t^^^^^tstes 4-^ 6ATV/6A0\ 

(acLdress to pUA/pUd; 


9UD4 / 


LDA 






$0D49 


STA 


$0A 




$UD4B 


LDA 


#941 


vput a copy or une name m 9 4Xi^r ; 


$0D4D 


STA 


$uF 




9UD4F 


T TMV 

LDA 


#90F 




$0D51 


^ m TV 

STA 


6 Am 
9OE 




J50DOO 


LDX 


•tt- 6 A TV 
f 9UA 


vparameters ror une r±exj.D±e copy 








rouuine/ wnicn is at. 9orrio/ 


9UDOO 


LDl 


A17 


\tne pointers can oe seiecueo. as 








Qes xrecL; 


$0D57 


LDA 


#$10 


(number of elements to copy) 


$0D59 


JSR 


$3FA6 


(call the copy routine) 


$0D5C 


LDA 


#$0D 


(parameters for the 


$0D5E 


STA 


$03 


window lie at 


$0D60 


LDA 


#$B1 


9UDBI; 


$0D62 


STA 


^ A 

$02 




$0D64 


JSR 


$C256 


(output window) 


$0D67 


LDA 


$02 


(button evaluation:) 


$0D69 


CMP 


#$02 


(was CANCEL clicked?) 


$0D6B 


BEQ 


$ODBO 


(yeS/ terminate) 


$0D6D 


LDA 


$416F 


(is a valid name in the buffer?) 


$0D70 


BEQ 


$0D5C 


(nOf repeat process) 


$0D72 


JSR 


$1F21 


(else store new name) 



The subroutine at $3FA8 is called to make a copy of a specific memory 
area. The pointers (in which the source and destination addresses are stored) 
are passed in the X and Y registers* In this case the source text address is in 
$OA/$OB and the destination address is in $OE/$OF. The accumlator 
contains the number of elements to be copied. 



238 



Abacus Software 



GEOS Inside and Out 



$3FA6 


STX 


$3FB4 




set source pointer 


$3FA9 


STY 


$3FB6 




set destination pointer 


$3FAC 


STY 


$3FC8 






$3FAF 


STA 


$20 




save number of elements 


$3FB1 


LDY 


#$00 




position to first value 


$3FB3 


LDA 


(...). 


Y 


copy 


$3FB5 


STA 


(...). 


Y 




$3FB7 


CMP 


#$A0 




shift space? 


$3FB9 


BEQ 


$3FBD 




yes^ don't count 


$3FBB 


STY 


$21 




else save number 


$3FBD 


INY 






and increment 


$3FBE 


DEC 


$20 




all characters copied? 


$3FC0 


BNE 


$3FB3 




no, keep copying 


$3FC2 


LDY 


$21 




increment number of valid 


$3FC4 


INY 








$3FC5 


LDA 


#$00 




mark the end of the copy 


$3FC7 


STA 




Y 




$3FC9 


RTS 









A copy of the current diskette name is made. This allows the renaming 
process to be terminated at any time, even after changes have been made to 
the name, by clicking CANCEL. The address of the window's parameter 
table is passed in $02/$03. The table looks as follows: 

$0DB1 #$81 (job code for standard window) 

$0DB2 #$0B (job code for text output) 

$0DB3 #$04 (distance from left edge) 

$0DB4 #$20 (distance from top) 

$0DB5 #$B7 (low byte of the text address) 

$0DB6 #$3C (high byte) 

$0DB7 #$0D (job code for data input) 

$0DB8 #$10 (distance from left edge) 

$0DB9 #$30 (distance from top) 

$ODBA #$0E (data will be stored indirectly via $OE/$OF) 

$ODBB #$10 (maximum of 16 characters) 

$ODBC #$02 (display CANCEL field) 
$ODBD #$11 (distance from left edge) 
$ODBE #$48 (distance from top) 



$ODBF #$00 (end of table) 
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The additional job code $0B displays a request to the user to enter a new 
name for the diskette. The corresponding text string is located at $3CB7 and 
is preceded by the control code $18, which determines the type style. 

Let's go on to our third example-define our own window. 
A sample window 

We will now write an application to demonstrate how to create your own 
windows. This application displays a window with the text string CLICK 
YES TO SEE NEXT PATTERN. Then it places YES and NO buttons 
within the window. If you click YES it closes the window and then redraws 
it with a new shadow pattern until it displays the last pattern. If you click NO 
it closes the window and retums to the deskTop. 



4580 


A9 


FF 




LDA 


#$FF 


Load accumulator with $FF 


4582 


8D 


A5 


45 


STA 


$45A5 


Store it in 1st byte/window table 


4585 


EE 


A5 


45 


INC 


$45A5 


Increment 1st byte/window table 


4588 


AD 


A5 


45 


LDA 


$45A5 


Load acc. with 1st byte of table 


458B 


C9 


20 




CMP 


#$20 


Compare to #$20 - end of patterns 


458D 


FO 


11 




BEQ 


$45A0 


Branch to $45A0 if comparson is = 


458F 


A2 


A5 




LDX 


#$A5 


Load X with lo byte of table 


4591 


AO 


45 




LDY 


#$45 


Load Y with hi byte of table 


4593 


86 


02 




STX 


$02 


Store X and Y in pointer 


4595 


84 


03 




STY 


$03 


accessed by window subroutine 


4597 


20 


56 


C2 


JSR 


$C256 


Jump to window subroutine 


459A 


A5 


02 




LDA 


$02 


Get the "clicked" window button 


459C 


C9 


04 




CMP 


#$04 


Compare to #$04 - the NO button 


459E 


DO 


E5 




BNE 


$4585 


Branch not = to increment pattern 


4 5 AO 


4C 


4A 


CC 


JMP 


$CC4A 


Jump to reload deskTop 
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The following is the window table used by the above program. 



45A5 01 14 50 

45AD OA 10 B8 

45B5 IB 28 00 

45BD 20 18 59 

45C5 4F 20 53 

45CD 58 54 20 

45D5 52 4E 00 



10 00 28 01 OB 

45 03 02 28 04 

43 4C 49 43 4B 

45 53 IB 20 54 

45 45 20 4E 45 

50 41 54 



. .CLICK 
.YES. .T 
O.SEE.NE 
54 45 XT.PATTE 
RN 



Open a non-standard sized 
window, upper border-$14, 
lower-$50, left-$0010 
right-$0128. Output text at 
($0A,$10) from text table at 
$45B8. Put a YES button at 
($02*8, $28) and NO at 
($1B*8,$28). $00 ends the window table. 
The text table starts at $45B8, 
contains the string "CLICK YES TO SEE 
NEXT PATTERN" and is ended with $00. 



The following is a BASIC program that creates the file window on disk. 
With a monitor, you can load window directly into memory and modify it 
to try some of the other job codes. 
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1000 rem ««*««**«*«****«***«««»« 
1010 rem * from the book * 
1020 rem *'geo5 inside and out'# 
1030 rem * published by abacas * 
1040 rem «******«****«*«**«*»«*« 
1050 open 1,8,2, "window, p,w" 

1060 print#l,chr*(128) 5chr*(&9) ; srem load addr of 
*4580 

1070 read>:*:i-f k*="xx "thenl lOO 

1080 y*=le-ft*(K*, 1) sgosub 1120:2=v«16 

1090 y*=right*(M*, 1) sgosub 1 120sz=z+v:print#l , chr* 

(z ) ; : ck=ck+z : gotoio70 

1100 closelsi-f ck<>7105thenprint"error in data" 
1110 end 

1 120 v=- (y*="a" ) * 10- (y*="b" ) « 1 1- (y*="c" ) * 12- (y*="d 

" ) *13- (y*="e" ) « 14- (y*=""f " ) * 15 

1130 v=v+val (y*) s return 

1140 rem machine code 

1150 data a9, -f -f , 8d, a5, 45, ee, a5, 45 

1160 data ad, a5, 45, c9, 20, f 0, 1 1 , a2 

1170 data a5,a0, 45, 86, 02, 84,03,20 

1180 data 56, c2, a5, 02, c9, 04, dO, e5 

1190 data 4c, 4a, cc, 00, 00 

1200 rem table for window parameters 

1210 data 01,14,50,10,00,28,01,0b 

1220 data Oa, 10, b8, 45, 03, 02, 28, 04 

1230 data lb, 28, 00 

1240 rem text for window 

1250 data 43,4c,49,43,4b,20, 18,59 

1260 data 45, 53, lb, 20, 54, 4f , 20, 53 

1270 data 45, 45, 20, 4e, 45, 58, 54, 20 

1280 data 50, 51 , 54, 54, 45, 52, 4e, 00 

1290 data xx 

To convert window into a GEOS application, load and run FILEMASTER. 

Insert the disk containing window and press any key (as prompted)* Type 
csp to create your icon. We created a picture of a window. Next, type iff 1 
to read the file window. Type window for the name to be searched for. 
Once the name is found, enter the date. Now, type geos to convert it to a 
GEOS file. Enter 6 for application. Type info to create the info sector for 
window. Enter as follows: 
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Starting address 
End address 
Entry point 
Program class 
Author's name 
Help screen 



17790 
17789 
17792 
example 
Russ Taber 

this program demonstrates how to 
create your own windows 



Once entered and back to the main menu, type end to quit. Now, load in 
GEOS insert your disk containing window and then open window. You 
should see the following display: 




Figure 84: window demonstration 
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6«3 The system interrupt 



The system interrupt in GEOS has essentially the same function as in the 
original C-64 operating system. It relieves the main program of a number of 
routine tasks. To accomplish this, the main program is interrupted at regular 
intervals and a special routine is executed. When an interrupt request is 
made (IRQ), the processor fet ches the start ing address of the interrupt 
routine from memory locations $FFFE/$FFFF (Low/High). 

Normally the interrupt routine is at $EA31 and performs such tasks as 
reading tiie keyboard, flashing the cursor, and actualizing the system clock, 
TI$. In GEOS, this routine starts at $E2DC. It reads the joystick from the 
joystick port, reads the keyboard, and decrements certain memory locations 
on each pass. 

An interrupt can be caused by various general events: 

• sprite-sprite collision 

• sprite-background collision 

• raster line of the video controller 

• light pen 

• timer 

• handshake for data transmission 

• alarm clock 

• BRK command 

In the original C-64 operating system, the interrupt is generated by a timer. 
In GEOS, the video controller raster causes the interrupt GEOS also allows 
for a BREAK interrupt. 

The raster-line IRQ is generated as follows: 

Register 18 of the VIC contains the number of raster line. When this line is 
being drawn on the screen, the VIC generates an IRQ to the processor. 
Raster line means that the interrupt will occur at the very top of the screen. 
If the desired value is greater then $FF, the overflow bit can be placed in bit 
7 of register 17. To actually generate an interrupt, bit in register 26 (mask 
register) must be set. 
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Since an IRQ can interrupt the processor during any activity, the following 
rule must be noted: If any of the processor registers are changed during the 
IRQ routine, the previous values must first be saved. This is normally done 
by placing them on the stack (PHA, TXA, PHA, TYA, PHA). The registers 
are then restored before retuming to the interrupted main program. 

If the processor cannot be interrupted during certain activities, it is possible 
to disable interrupts requests by executing the SEI instruction in the main 
program. Interrupts can be enabled again with the CLI instruction. 

Let's take a look at the system interrupt in GEOS. 



$E2DC 


STA 


$880B 


save ace 


$E2DF 


PLA 




get status from stack; placed there 
automatically on interrupt 


$E2E0 


PHA 




write status back; since the status is 
the ace, it can be tested 


$E2E1 


AND 


#$10 


test BREAK flag 


$E2E3 


BEQ 


$E2E9 


no BREAK, system interrupt 


$E2E5 


PLA 




status no longer needed 


$E2E6 


JMP 


($84AF) 


indirect jump to routine: "System error 
near XXXX" 


$E2E9 


TXA 




system interrupt 



BREAK IRQ 

With the branch to a special routine on BREAK IRQ, GEOS has the ability 
to display a message and memory location on the screen for even serious 
program errors. This is possible because the retum address is placed on the 
stack when an interrupt request is serviced. This address is fetched from the 
stack with ($84AF) and printed on the screen. 

System IRQ 

After the processor registers and important memory locations have been 
saved on Sie stack, the interrupt service routine (at $E306) performs the 
following tasks: 
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• Enable I/O area 

• Decrement counter $8515 by one. This is not done if the 
counter value is already zero. 

• Decrement counter $87EA by one. This is not done if the 
counter already contains the vaJue $00 or $FF. 

• Jump to routine $E36F to read the keyboard. 

• Decrement counter $881B, end if $881B=0. This counter 
creates the interval for tfie tone creation m case of an alarm. 

• Execute job 1: Address of the job in $849D/$849E. This job is 
normally $E360= joystick movement 

• Execute job 2: Address in $84DF/$84A0. Normally both 
memory locations are zero, so that this job is not executed. 

Following this, the saved memory locations and registers are restored from 
the stack and tiie retum from the interrupt is prepared. 
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6.4 Job loop / Job structure 



One of the flexible programming features of GEOS is something weVe 
called the job loop. This program section checks certain memory locations 
to see if jobs are supposed to be executed. These can even be placed on 
stack and processed in succession. In addition, the job loop contains two 
routines involved with the alarm clock. The job loop starts at $C2C8 and the 
actual main routine is relatively short: 

C2C8 JSR $E28F 
C2CB JSR $9EA9 
C2CE JSR $9F79 
C2D1 JSR $F930 
C2D4 JSR $F9ED 
C2D7 LDA $849B 
C2DA LDX $849C 
C2DD JSR $C1D8 
C2E0 CLI 
C2E1 JMP $C2C8 

If you want to write your own programs to work under GEOS, you can 
save yourself a great deal work if you are familiar with the basic function of 
the job loop. Well briefly explain the operation of the individual routines 
here. 

First we have to talk a little bit about the interrupt, which accomplishes 
important tasks in GEOS. One of its responsibilities is reading the joystick. 
Several memory locations play an important role in understanding the 
interrupt routine. On one hand, the interrupt is informed as to whether the 
joystick cursor is enabled or disabled, visible or invisible, whether it may 
go beyond certain boundaries (important so that the cursor cannot leave 
certain windows), and so on. On the other hand, the interrupt tells the 
program whether tiie cursor moved, whether the button was pressed or not, 
etc. 



1. C2C8 JSR $E28F 

This subroutine checks memory location $39. In this location the interrupt 
passes information on whether the joystick was moved or the button was 
pressed: 
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E28F 


BIT 


$39 


test joystick status 


E291 


BVC 


$E2A2 


bit 6=1; new stick posit 


E293 


LDA 


#$BF 


clear bit 6 


E295 


AND 


$39 




E297 


STA 


$39 




E299 


LDA 


$84A5 


job address low 


E29C 


LDX 


$84A6 


job address high 


E29F 


JSR 


$C1D8 


job entry 


E2A2 


LDA 


$39 




E2A4 


AND 


#$20 


bit 5=1; change on butto 


E2A6 


BEQ 


$E2B7 


no, continue 


E2A8 


LDA 


#$DF 


yeSf clear bit 


E2AA 


AND 


$39 




E2AC 


STA 


$39 




E2AE 


LDA 


$84A1 


job address low 


E2B1 


LDX 


$84A2 


job address high 


E2B4 


JSR 


$C1D8 


job entry 


E2B7 


BIT 


$39 




E2B9 


BPL 


$E2C7 


bit 7=0; no job in FIFO 


E2BB 


JSR 


$E515 


read new job from FIFO 


E2BE 


LDA 


$84A3 


job address low 


E2C1 


LDX 


$84A4 


job address high 


E2C4 


JSR 


$C1D8 


job entry 


E2C7 


LDA 


$84B6 


job flag set? 


E2CA 


BEQ 


$E2DA 


no 


E2CC 


LDA 


$84A7 


job address low 


E2CF 


LDX 


$84A8 


job address high 


E2D2 


JSR 


$C1D8 


job entry 


E2D5 


LDA 


#$00 




E2D7 


STA 


$84B6 


reset job flag 


E2DA 


RTS 







This routine makes it possible to execute jobs independently of the value of 
the joystick port. The big advantage of this routine is that program can wait 
for a change in the joystick port without being stuck in a loop, simply 
reading the joystick status. This way GEOS can update the system clock 
time while geoPaint waits for a joystick movement. 

You can write your own values in the jump addresses and execute program 
fragments independent of changes of the joystick. You could use this to 
write a hardcopy routine which waits for the user to press the fire button 
and then stores tiie contents of the screen. 
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FIFO (First In, First Out) is a buffer to which two pointers point. The first 
pointer indicates the next free position within the buffer. The second points 
to the next element to be processed. The pointers are actualized each time the 
buffer is accessed. When a new job is written in the buffer, GEOS advances 
the first pointer one position. When a conmiand has been processed, the 
second pointer is incremented by one position. This causes the second 
pointer to lag behind the first. The buffer is actually a "circle", and holds a 
maximum of 16 entries. When the second pointer catches up to the first (i.e. 
no more commands need be processed), bit 7 in $39 is cleared. When a new 
command is added to the buffer, bit 7 of $39 is set to one. 



2. C2CB JSR $9EA9 

This routine manages a table of jobs which are processed depending on a 
status word. In addition, a special bit in the status word can be used to 
disable the processing. 





T P\V 


6 Q '7 QT? 


job number 








no job 


9EAE 


DEX 






9EAF 


LDA 


$872A,X 


get job flag 


9EB2 


BPL 


$9ED3 


bit 7=0; already executed 


9EB4 


AND 


#$40 


bit 6=1? 


9EB6 


BNE 


$9ED3 


yes^ then skip 


9EB8 


LDA 


$872A,X 


reset flag 


9EBB 


AND 


#$7F 




9EBD 


STA 


$872A,X 




9EC0 


TXA 




save job number 


9EC1 


PHA 






9EC2 


ASL 




*2 


9EC3 


TAX 






9EC4 


LDA 


$873E,X 


job address low 


9EC7 


STA 


$02 


save 


9EC9 


LDA 


$873F,X 


job address high 


9ECC 


STA 


$03 


save 


9ECE 


JSR 


$9ED7 


job entry 


9ED1 


PLA 




get job number back 


9ED2 


TAX 






9ED3 


DEX 




next job 


9ED4 


BPL 


$9EAF 


another job 


9ED6 


RTS 






9ED7 


JMP 


($0002) 
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3. C2CE JSR $9F79 

This routine manages a job buffer in which a two-byte counter (16-bit) 
belongs to each job. This counter delays the execution of the job. 



9F79 
9F7C 
9F7E 
9F7F 
9F82 
9F85 
9F87 
9F8A 
9F8C 
9F8F 
9F91 
9F92 
9F93 



LDX 
BEQ 
DEX 
LDA 
ORA 
BNE 
LDA 
STA 
LDA 
STA 
TXA 
PHA 
JSR 



$878F 
$9F9E 

$8790, X 

$87A4,X 

$9F9B 

$87CC,X 

$03 

$87B8,X 
$02 



$9FA8 



9F96 JSR $9F9F 

9F99 PLA 
9F9A TAX 
9F9B DEX 
9F9C BPL $9F7F 
9F9E RTS 



job nuitiber 
no job 

counter low 
counter high 
not 0, skip 
job address high 

job address low 



save job number 

advance jobs; current job number 
overwritten 

job entry + 1 because address is 
fetched from the stack by JSR 
get job number 
and into X 
next job number 
another job present 



9F9F INC $02 job address + 1 and execute 

9FA1 BNE $9FA5 
9FA3 INC $03 
9FA5 JMP ($0002) 



This job table is used by GEOS when you click an OK button. The button is 
first inverted (black instead of white) and then inverted again after a very 
brief pause. The counter determines the length of this pause, which in this 
case contains the value $00A0 as the starting value. The interrupt 
decrements the counter. 



There is a routine at $9FDE to which the starting value is passed in 
$03 , $02. It fetches the next free location in the table from $877E and 
writes the starting value for the counter to the corresponding positions in the 
table. The retum address is then fetched from the stack and written into a 
second table. When the counter reaches zero, the retum jump is made. 
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4. C2D1 JSR $F930 

Date maintenance. 

5. C2D4 JSR $F9ED 

Alarm clock evaluation. 

6. C2D7 LDA $84 9B job address low 
C2DA LDX $84 9C job address high 
C2DD JSR $C2D8 job entry 

7. C2E0 CLI 

C2E1 JMB $C2C8 

Enable interrupts and return to the start of the job loop. 
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6.5 The GEOS file structure 



One of GEOS* many strong suits is its file structure* Numerous GEOS 
features are made possible with its file management. When we first started 
working with GEOS and discovered the changes from the normal file 
structure, we thought that it was an attempt on the part of tiie makers of 
GEOS to protect development secrets. But we soon discovered that each of 
the changes had an important function in GEOS. In this section we want to 
explain 5ie details of the GEOS file structure. To do tiiis, we must first 
explain how the normal Conmiodore DOS manages files. 



6.5.1 FUe management under Commodore DOS 



Every file on the diskette has a file entry or directory entry which contains 
all of the important information about the file. The directory is found on 
track 18 of the diskette, and starts at sector 1. 



Here's the format of a directory entry: 

File type »ORed with $80 

1 ,2 Track and sector of the first data block 

3-18 Filename, padded with shifted spaces ($ AO) 

1 9-2 1 Used only for relative files 

2 1 Used only for relative files 

22-25 Not used 

26,27 Track and sector of the new file when overwriting 

28,29 Number of blocks in the file (low/high) 

t File types: = deleted 

1 = sequential 

2 = program 

3 = user 

4 = relative 
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An example: 

01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 
C2 11 00 F I L E N A M E AO AO AO AO 

16 17 18 19 20 21 22 23 24 25 26 27 28 29 
AO AO AO 00 00 00 00 00 00 00 01 00 OA 00 

This file is a program, because the lowest 4 bits in byte 01 equal 2. In 
addition, it is write-protected, because the 6th bit is set (C2 instead of 82). 
The first data block of the program lies on track 17 (=$11), sector 0. The 
file contains one data block, which is one sector (byte 26=01). From the 
number of zeroes in the file entry you can see tiiat there is space for 
additional information. This space is used by GEOS. We will now take a 
look at a file entry under GEOS. 



6.5.2 A me entry under GEOS 



A file entry in GEOS contains more information than a normal '64 file. This 
additional information is at the following locations and has the following 
meanings: 

Bytes 19,20 : Sector of the INFO screen 

Byte 21 : File structure 

= SEQUENTIAL 

1 =VLIR 



Byte 22 : File type 

1= BASIC 

2 = machine language 

5 = GEOS desk accessory (e.g. the alarm clock) 

6 = GEOS application (e.g. geoPaint) 

Bytes 23-27 : Date and tune, starting with the year 

Let's look at such a GEOS file in detail. As an example we'll select the 
program GEOS BOOT and show the corresponding section of the directory: 
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A GEOS file entry: 

0320 C2 01 10 47 45 4F ..b..geo 

0328 53 20 41 4F 4F 54 AO AO s boot.. 

0330 AO AO AO AO AO 01 08 00 

0338 02 56 03 07 OF 00 06 00 .v 

0340 00 00 

The file entry starts at $0322. The first bytes correspond exactly to 
Commodore DOS. This is important so that the files can be loaded without 
GEOS. The additional information that GEOS places in the file entry starts 
at byte $0335 behind the last $A0. The INFO sectcff lies at track 1, sector 8. 
The file structure is SEQUENTIAL and the GEOS file type is a machine 
language program (02). 

Following this are the date and time: 

Year, month, day, hour, minute 

Only the last two digits of the year are included, so $56 = 86 = 1986. The 
hours are entered in 24-hour format: $0F =15 = 3 PM. 

We have printed a larger section of the directory below so that you can 
become better acquainted with the GEOS file entry structure and the 
additional information. Study the file entries until you are comfortable with 
the pattern. The GEOS information always starts after the last $A0. 

Note that GEOS uses a somewhat different coding of the characters than 
usual. The ASCII values differ from the usual values: 



0300 


12 


09 


C2 


11 


00 


47 


45 


4D 


. .b . . geo 


0308 


53 


AO 


AO 


AO 


AO 


AO 


AO 


AO 




0310 


AO 


AO 


AO 


AO 


AO 


00 


00 


00 




0318 


00 


00 


00 


00 


00 


00 


01 


00 




0320 


00 


00 


C2 


01 


10 


47 


45 


4F 


. .b . . creo 


0328 


53 


20 


42 


4F 


4F 


54 


AO 


AO 


s boot . . 


0330 


AO 


AO 


AO 


AO 


AO 


01 


08 


00 




0338 


02 


56 


03 


07 


OF 


00 


06 


00 




0340 


00 


00 


C3 


01 


11 


47 


45 


4F 


. . c . . geo 


0348 


53 


20 


4B 


45 


52 


4E 


41 


4C 


s kernal 


0350 


AO 


AO 


AO 


AO 


AO 


01 


09 


01 




0358 


04 


56 


03 


07 


OF 


00 


54 


00 


. V. . . .t . 


0360 


00 


00 


C3 


05 


07 


44 


45 


53 


. . c . . des 
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0368 4B 20 54 4F 50 AO AO AO k top... 

0370 AO AO AO AO AO 05 14 01 

0378 04 56 03 07 OF 00 47 00 .v g. 

0380 00 00 C3 08 OF 47 45 4F ..c.geo 

0388 50 41 49 4E 54 AO AO AO paint... 

0390 AO AO AO AO AO 08 06 01 

0398 06 56 03 07 OF 00 5B 00 .v 

03A0 00 00 C3 OD 02 47 45 4F ..c*.geo 



6.5.3 The INFO sector 



Every GEOS file has an INFO sector, which contains information about the 
file. The address of the INFO sector is located in the file entry behind the 
last $A0, bytes 19 and 20. Under Commodore DOS these bytes are used 
only for relative files. 

In the INFO sector the bytes have the following meaning: 

0-1 GO, FF - Normally the first two bytes contain the pointer to 
the following sector. Byte = track, byte 1 = sector. Since 
there is only one sector, byte = $00 and byte 1 specifies 
the number of valid bytes in this sector. The first two bytes 
thus correspond to the standard Commodore DOS format. 

2-3 These two bytes specify the size of the icon that symbolizes 
this file on the screen. Byte $02 indicates the widtti and byte 
$03 the height. A width of 3 means that the icon is three 
bytes wide and the height of $15 = 21 lines. The icon 
therefore has the same format as a sprite, which also 
consists of 63 bytes. 

4 This byte represents a flag, the so-called bit-mapping flag. 

The highest bit is always set ($80) and the lower bits 0-6 
specify the number of bytes in the icon ($3F = 63). 

5-67 Sprite representation of the icon. Here are the 63 bytes that 
determine the appearance of the icon. They are in sprite 
format, so that 3 bytes correspond to one line of the sprite. 
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68 File type (C-64) ORed with $80. GEOS checks to see if the 
file is data (=1) or a program (=2). $82=130 must be here 
for a program. 

69 GEOS file type (BASIC = 1, machine language = 2, 
ACCESSORY = 5). 

70 GEOS file structure type (0 = SEQ, 1 = VLIR ). SEQ = 
SEQUENTIAL here does not mean quite the same thing as 
in Commodore DOS, but just that the sectors are chained via 
the pointers in bytes 0,1. SEQ means the normal file 
structure. VLIR (Variable Length Indexed Record) 
represents a different format of file. Well talk about this a 
little later. Programs that you write yourself = 0. 

71,72 Load address of the program. GEOS will load the program 
into memory at this address. Note: Normally bytes 2,3 in 
the first data sector of the program specify the start address. 
This is different in GEOS, and we will explain later how to 
avoid difficulties that arise because of this. 

73,74 These two bytes have significance only for accessories. If 
you enter a GEOS file type of 2, you don*t have to worry 
about these bytes. However, if you enter 5, for accessory, 
then these bytes determine the end of the program. This way 
GEOS knows what area to save out to the disk as a SWAP 
file when loading the accessory. 

75,76 Entry point of the program. GEOS will begin executing 
your program at this address. 

77-159 The strings that will be printed in the info box will be 
stored here. They must be terminated with 0. 

77-96 CLASS = type of program 

97-159 Name of the author 

160-254 Information text. This will be printed only if the disk is on 
the deskTop. 

255 =0, because the information string is terminated with a zero. 
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As an example, we will look at the INFO sector of ALARM CLOCK. 
Viewed with a disk monitor, it looks as follows (note that GEOS uses a 
different coding system for the characters): 



uouu 


u u 


fir 

£ £ 


Uo 


Xo 


£5£ 


£ £ 


f XT' 
£ £ 


£ £ 




UoUo 


o U 


UU 


U X 


Q Q 
OO 


oU 


UX 


oU 


TV K 

AD 






o ± 


P Q 

o y 


/ £j 


Q1 

y X 


y o 


P 1 

oX 


oy 


y b 




U*3 xo 


HP 
U 


^ Q 

y 


ou 


A Q 

y 


X 
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We printed the character equivalents only for bytes that contain text 
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At $0347 we see (in the format low byte/high byte) the load address 
($5400), the end address ($5FD8), and the entry point ($5400). When 
loading the ALARM CLOCK, the area $5400-$5FD8 is first saved as a SWAP 
file to diskette. When you want to exit alarm CLOCK, GEOS loads the 
SWAP file back at this location. With this method, an accessory can be 
loaded from any application without losing any data. 



6.5.4 The border and GEOS format V1.0 



There are still two more features of the GEOS file structure we have to 
discuss. But to do so, we must first look at the BAM of a diskette. It is 
always located at track 18, sector 0. Normally the Commodore DOS places 
the following information in the BAM: 

Bvte Meaning 

0, 1 Track and sector of the first block of the directory 

2 Format (A = 1541 format) 

3 

4-143 Bit pattern of the occupied and unoccupied blocks 
(O=occupied). Set up in groups of four bytes, whereby 
each group characterizes one track. The first byte 
specifies the number of free blocks on the track and the 
next three bytes the bit pattern for the sectors 0-7, 8-15, 
16-23. 

144-161 Name of the diskette padded with Shifted space = $A0 

162-163 ID of the diskette 

164 Shifted space ($A0) 

165-166 2A = format and DOS version 

167-170 Shifted space ($A0) 

171-255 Not used, filled with zeroes 
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Like the directory, we also have a good deal of unused space here. GEOS 
uses iMs area for its own purposes. Additional information is placed at two 
locations: 

171-172 Track and sector of the border. When you use a disk 
with GEOS that was not formatted under GEOS, the 
error message THIS IS NOT A GEOS-FORMATTED 
DISK appears. 

You can convert the disk to GEOS format. Another block is reserved, and 
the pointer in 171,172 points to this block, which represents an extension of 
the directory. All files which GEOS places on the border receive the 
character for "scratched" in the normal directory and are entered in this 
border block. Since only eight file entries fit in a sector, you can place a 
maximum of eight files on the border. 

173-188 geos FORMAT vl.O 

The GEOS format is placed here at the same time the 
border block is allocated. From the entry vl . we see 
that the GEOS file structure has not changed with the 
new version 1.2. GEOS uses this entry to determine 
whether or not a disk is in GEOS format when opening. 

Now let's take a look at the BAM of a GEOS diskette: 
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The pointer for the border block points to track $13, sector $08 (19, 8). We 
also want to look at this block to show that it is constructed just like a 
directory block: 
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Here again we have given the character equivalents only for the names and 
replac^ the rest wiSi periods. Note the unusual notation. The first letter 
appears in lower case and the rest in upper case. We have used this 
representation here because this is how the file entries would look if you 
used a disk monitor to examine them. 
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The first two bytes of the border block indicate that there is no block 
following this one and that there are $FF (=255) valid data present Only the 
first two file entries (mps-1000 and mps-803) are valid because only 
they have a valid file type ($83). The following file entries do not appear on 
the border because their file types are set to 0. 

Note: If you place a file on the border and then exit GEOS, you will not be 
able to load it again without GEOS > GEOS erases the file from the normal 
directory. If you place GEOS BOOT from the distribution disk on the border 
and then exit GEOS, you won't be able to boot GEOS any more. 



6.5.5 FUe type / Ftte structure 

When you want to use programs of your own under GEOS, youll have to 
know what file types GEOS uses. You may have seen terms like SYSTEM 
FILE, DESK ACCESSORY, FONT FILE, and SO on appear under TYPE 
in the INFO screen of various GEOS files. GEOS distinguishes between a 
total of ten different file types. We have listed these file types: 



GEOS rde type 
(GT) 
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(FS) 
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(INFO window) 
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Desk Access. 


ALARM CLOCK 
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Application 


GEOPAINT 
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1 


Appl, Data 


NOTES 
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Font file 


UNIVERSITY 
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Printer Drive 


MPS 1000 


10 
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Input Driver 


JOYSTICK 
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GEOS also recognizes what you can do with this file from the file type. For 
example, you can't print a desk accessory (GT=5) or copy a system file 
(GT=4). 

Now we'll explain the difference between FS=0 (SEQ) and FS=1 (VLIR). 
File structure: SEQ 

If you store a program without GEOS, a directory entry will be created. A 
pointer to the first data block will be placed behind the file type. At the start 
of the data block there is a pointer that points to the data block following it. 
The last block of data always has a as the first byte. The second byte 
specifies the number of valid bytes in the last sector. This combines the 
individual data blocks into a long chain. That's why GEOS calls this type of 
file SEQUENTIAL. 

For example, if you want to read the last data block, you would have to 
follow all of the pointers until you got to the last block. All of the previous 
sectors in the chain must be loaded. In addition, you can only add tilings by 
lengthening the chain. For this reason GEOS has a second file structure. 

File structure: VLIR (Variable Length Indexed Record) 

If you use the disk monitor to look at the file entry of a file that has the 
VLIR file structure (such as deskTop), you won*t see any difference at 
first. But when you load the first data block (track and sector behind the file 
type), youll be surprised to see that there is only one sector of data. The 
first byte of the first sector is zero, meaning that no additional sectors 
follow. Furthermore, this sector does not contain the start of the program or 
data, but just a few numbers and the rest of the block is alternately filled 
with 00 and FF. 

The first numbers in this sector represent pointers to records of the program 
of data. These records are again joined to each other sequentially, with a 
pointer at the start of each block to the next one. This has two important 
advantages: 

First, the length of the individual program or data records can be changed. 
Additional sectors can be added. Second, the last sectors can be accessed 
faster because the first blocks need not be read. 

One of the places GEOS makes use of this is in the note pad, which has a 
VLIR file structure. There can be up to 127 pointers to pages of the note 
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pad. Each record corresponds to a page and consists of just one sector. If 
you fill pages of the pad with NOTE PAD 3 and then use the disk monitor 
to look at the sector specified as the first block of the file, six bytes will 
show up behind the first two bytes $00 and $FF, These are the pointers to 
the three sectors in which the text is stored. The pointers have the format 
track, sector. 

In addition to data, GEOS also recognizes programs with the VLIR file 
structure. Here the construction looks the same — a pointer points to each 
record — but loading is done differently. Usually the first record represents 
the entire program. The other pointers point to records that can be loaded 
using the overlay technique. This involves overwriting parts of the existing 
program with other sections loaded from disk as they are needed. 

For example, geoPaint has seven pointers: 



These pointers can have different values on your disk. 

When you click geoPaint on the deskTop, the first record (track $08, sector 
$03) is loaded. The other records can then be loaded by geoPaint to 
accomplish specific tasks. 

We'U use two examples to illustrate the overlay technique. 



track 



septor 



$08 
$10 
$10 
$10 

$11 

$13 
$13 



$03 

$11 

$0A 

$06 

$12 

$05 

$0F 
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1) deskTop consists of two records: 

Record 1 : track $05 sector $10 

Record 2: track $08 sector $02 

Normally record 1 is loaded. When you load the INFO sector, 
however, the text in record 2 is loaded for the output. You can 
see this if deskTop is not on the current disk and no text will 
be printed, but this error message appears: 

DESKTOP NOT ON DISK 



2) When you select various tools in geoPaint, routines belonging 
to the given tool are loaded from disk. Record 2 of geoPaint 
(track $10, sector $11), for example, belongs to the "faucet" 
used to fill surfaces. 

How can you load a record? Using your disk monitor, find the track and 
sector of the record you want to load. Then create a dunrniy program, which 
well use to create a file entry. 

You can create a dunraiy program in BASIC by entering the following: 

NEW 

10 GOTO 10 

SAVE "dummy", 8 

Now you to know two things: 

1. The start address of the record in memory. 

Look in the file entry to find out where the INFO sector of the record you 
want to load is located. The track and sector of the info box are after the 
last $A0 of the file entry. Load this sector into the disk buffer and the load 
address of die record will be in memory locations $0347 (low byte) and 
$0348 (high). geoPainf s start address is $0400. 
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2. You must change the first two bytes of the record. In our example, 
put the first block (track $08, sector $03) in the buffer. The first 
bytes are then: 

$0300 = track of the next block 
$0301 = sector of the next block 
$0302 = $4C = JMP 
$0303 = $04 = address: low 
$0304 = $05 = address: high 

To load the record at the correct address, write down byte $0302=$4C and 
byte $0303=$04. Then change these so that $0302=$02 and $0303=$04. 
When you later load this record, GEOS will look for the load address in 
these two bytes. The address must be two bytes higher than the load 
address of the record, because the first two bytes will be overwritten and 
you will have to insert them yourself after loading. 

Now write the modified sector back to the disk. Read the part of the 
directory that contains the file entry dummy into the disk buffer. In this 
entry, change the address of the first data block to the address of the record. 
Behind the $82 (file type in the file entry) write a $08 (start track of the 
record) and then a $03 (start sector of the record). Your "dummy" file entry 
now begins with the three bytes: 

$82 $08 $03 

After you have written the modified directory sector back to the disk, you 
can load the record simply by loading dummy. 

LOAD "dummy", 8,1 

Once you insert the two missing bytes with the monitor, you have geoPaint 
in memory. Change $0400 to $4C and $0401 to $04. 

Here we face the difficulty that the screen normally lies at $04(X). We can 
get around this by loading geoPaint with an offset of $1000. To do this, 
write $02, $14 in the first block of the record instead of $02, $04. This will 
load geoPaint at $1402, and you can examine the program at your leisure. 
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6.6 Writing your own GEOS programs 



In this section we want to show you various ways of loading your own 
programs under GEOS and adding your own GEOS applications. Loading 
your own programs from GEOS is especially interesting because the 
fast-loading routines of GEOS can be used under certain circumstances. 



6.6.1 How to load your own programs 



With GEOS you can load programs written in BASIC or assembly 
language. There are some differences. 

a) BASIC programs 

You can load any BASIC program from GEOS by double-clicking the 
program icon or by clicking OPEN. GEOS recognizes a BASIC program by 
the starting address $0801=2049, which is located in the first data block of 
the program on disk behind the pointer to the next block. GEOS then checks 
to make sure that the program does not exceed a certain length. The GEOS 
fast-loading routines use memory starting at $8000 in the C-64. If the 
BASIC program does not extend into this area, it will be fast-loaded with 
these routines and automatically started 

If the program is too large, it will be loaded by the normal '64 operating 
system, which is slower. The program can still be loaded by double- 
clicking, however. 

b) Assembly language programs 

GEOS recognizes programs written in assembly language by a starting 
address that is not equal to $0801. These programs can be loaded only if the 
start address is under $0400. Such programs usually use the stack or 
auto-start start area. We found that the slow C-64 routines were always 
used for loading assembly language programs. 

With a little trick, however, it is possible to use the fast GEOS routines for 
assembly language programs as well. To do this, simply convert the 
program into a BASIC program. To do this convert your program to start 
with a SYS command. If your program isn't in the location you want, youll 
have to write a routine to transfer it to where you want it, as follows: 
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$0801 = 2049: 10 SYS 2080 

($0820 = 2080: move routine; moves the program into 
the memory area for which it was written.) 

$0850 = 2128: Actual program to follow move routine 

With this method, assembly language programs can also be loaded with the 
fast-loading routines and then started automatically. 



6.6.2 How to extend GEOS with your own programs 



There are two ways to wedge your own programs into GEOS. Both 
methods require a comprehensive knowledge of GEOS internal operations. 

a) Applications 

Let* s start with the simpler method. We want GEOS to load a user program, 
start it, and then retum to the deskTop when the program is finished. To 
achieve this, you have to write your own APPLICATION in assembly 
language, because the BASIC interpreter is not available under GEOS. In 
addition, the screen output must take place on the hi-res screen at $A000. 
How is this type of program inserted in GEOS? 

1) Place a JMP $CC4 A at the end of your program. First you must 
set up your program so it can retum to GEOS. Branching to this 
address causes the deskTop to be reloaded. As long as you did 
not change the screen colors, the deskTop returns with its 
previous colors. If you did change the colors, a PREFERENCES 
file must be on the diskette to set the colors back to the correct 
values. 

2) Save the program. Now it must be converted into an application. 
Use a blank work diskette in case an error occurs. You can later 
copy the program from this work diskette to the desired disk. 

3) Now the actual conversion to the format of an application must 
take place. You can accomplish this with a disk monitor or more 
easily with the FILEMASTER program (listed in Chapter 5). 
Applications are GEOS file type 6. 
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The following changes must be made: 

• Your program must contain an INFO sector. The track and 
sector must be located after the last $A0 of the filename. 

• Change the next two bytes to and 6, respectively. The first 
byte signifies the file structure (SEQ) and the second byte 
indicates the GEOS file type (application). 

You can make this change with the FILEMASTER program by selecting 
RFL, read file. Select GEOS from the menu and 6 to set the GEOS file type. 
You can also enter a date (date). 

With INFO sector, the following bytes in the buffer must be set to the 
following values (buffer = $0300-$03FF). 

Byte $0344 = C-64 file type (such as $82) 

Byte $0345 = GEOS file type (=6) 

Byte $0346 = File structure (=0=SEQ) 

Byte $0347 = low-byte of load address 

Byte $0348 = high-byte of load address 

For the load address, you must enter a value of where your program is to 
load into memory. The regular DOS used by the computer saves two bytes 
at the start of your program to tell it where to load. GEOS takes care of this 
in the INFO sector, and therefore doesn't use these two bytes. If you saved 
your programs using regular DOS, then you have to offset the load address. 
GEOS will load those two extra bytes in, so you have to move the load 
address down by two. The following two example programs (application 
and accesory) do not use the regular DOS load address if loaded using the 
BASIC loaders. Therefore the two-byte offset is not needed. 

Byte $0349 = end address of the program (low) 

Byte $034A = end address of the program (high) 

WeVe found that this address is not used for applications. You should still 
enter a value here, however, since the geoWrite and geoPaint applications 
also have values here. These two bytes do not contain the actual end 
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address, they contain the entered load address minus one* Fo r exa mple, if 
we set the load address to $1000, the end address would be $OFET. 

For accessories, the memory between the load address and the end address 
entered is saved by GEOS as a SWAP file on the diskette. This is not done 
if you enter the value just described. 

Byte $034B = entry address (low) 

Byte $034C = entry address (high) 

This is the actual entry point of where your program takes over. 

After you have saved the changes on disk, the application is finished. You 
can now use it from GEOS. We would like to offer a simple example here. 
The following program causes the screen border to flash for several seconds 
at an increasing rate and then loads deskTop again. 
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In this example, set the following values with FILEMASTER under the 
option info: 

Load address = 17808 (17806 if you saved it with a monitor) 
End address = 17807 (17805 if you saved it with a monitor) 
Entry point = 17808 



b) Accessories 

The main advantage of accessories is that they can be loaded from any 
application as well as the deskTop, When you are finished working with the 
accessory, you can continue with the application where you left off. This is 
only possible because GEOS places certain parts of the program on the disk 
as a SWAP file. How does this work? 

Before the accessory is loaded, GEOS reads the start and end addresses. 
The area between these two addresses in memory is then saved out as a 
SWAP file on the diskette. The accessory is then loaded and can be started. 
When you want to leave the accessory again, GEOS loads the SWAP file 
back in at the correct location in memory and the previous program (the 
application) is set back in its original condition. 

You can test this with the RESET button on your computer (if you have a 
C-64 and haven't installed a reset button, then you'll have to take our word 
for it). Boot GEOS and open the alarm clock. After it is loaded, exit GEOS 
by pressing the RESET button. If you now boot GEOS again, you will 
discover a new file (perhaps not on the first page) which has the same icon 
as the alarm clock and is called SWAP file. If you look at the INFO sector 
of the SWAP file with your disk monitor, you will see that the load and end 
addresses match those of the alarm clock. After examining it, delete the 
SWAP file, for it is of no use anymore. 

How do you create your own accessories? 
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Basically, the same steps involved in making an application are necessary 
for making an accessory. The following changes must be made: 

GEOS file type = 5 

Set the end address of the program with the info option to the gnji address 
of the program, not to the load address minus one. 

Don't exit from the accessory with $CC4A. Exiting the program in this way 
is not possible for two reasons. First, the user should be able to load the 
accessory from geoPaint as well, and ending the program with JMP 
$CC4A would simply reload deskTop. Naturally, the current geoPaint 
screen data would not be saved. Second, a SWAP file would appear on the 
disk each time. 

There is a specific address provided for ending a desk accessory. When a 
branch is made to this address, GEOS loads the SWAP file from diskette, 
deletes, and then continues the program execution at a modifiable address. 

The entry address for loading the SWAP file is $918F. The KERNAL 
vextor pointing to this is $C23E. This address, where the program should 
continue after loading the SWAP file, is passed into $849B and $849C. 
This address is pushed on the job stack and then branched to with RTS. In 
this case the following bytes must be passed: 

$849B = $3E 

$849C = $C2 
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100 OPEN 1,8,2, "BCC ACC.,P,W" 

1000 F0RI=17S08T017831sREADX: CK=CK+ X 

1010 PRINT#1,CHR*(X) ; 

1020 NEXT 

1025 IFCK02635 THEN PR I NT "ERROR IN DATA" 
1030 CLOSE 1 
1040 END 

9000 DATA 165,1,72,9,7,133,1,238 

9001 DATA 32,208,104,133,1,162,62,160 

9002 DATA 194,142,155,132,140,156,132,96 



In this example, set the following values with FILEMASTER: 
Load address = 17808 (17806 if saved with a monitor) 
End address = 17832 
Entry point = 17808 
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6.7 Memory layout and memory locations 



If you want to wedge your own program into GEOS, you must know two 
things: 

• The memory map — ^what areas of memory your program can use 
without destroying GEOS. 

• Important memory locations — ^which memory locations GEOS uses 
for its purposes, and which locations must be saved before you use 
them for your own purposes. 

Let's start with the memory map of the C-64 in the basic GEOS 
configuration (GEOS KERNAL + deskTop). 



6.7.1 Memory map 



$0000-$OOFF 
$0100-$01FF 
$0200-$03FF 



$0406- 
$40FD- 
$4570- 
$496F- 
$4B00- 
$4C00- 
$4D00- 
$4E00- 
$4F00- 



$40FC 
$456F 
$496E 
$4AFF 
$4BFF 
$4CFF 
$4DFF 
$4EFF 
$4FFF 



Zero page, important pointers and system addresses 
Processor stack 

Essentially up to $0300-$0340, which contains the usual 
pointers. GEOS has set some of these pointers to its own 
values . 

Program deskTop 

Working memory deskTop 

Not used (safe for your own use) 

Working memory deskTop 

Directory page 1 (diskette) 

Directory page 2 

Directory page 3 

Directory page 4 

Directory page 5 
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$5000-$5FFF : Partially used as working memory 

$6000-$7F40 : Copy of the bit -mapping screen 

$8000-$80FF : Buffer 1 for reading or writing disk sector 

$8100-$81FF : Buffer 2 

$8200-$82FF : Buffer 3 for disk BAM 

$8400-$8BFF : Working area^ storage for mouse pattern ($84C0) , etc. 

$8C00-$8FFF : Color RAM 

$9000-$9FFF : GEOS kernal part 1 

$AOOO-$BFFF : Bit-mapping screen 

$COOO-$FFFF : GEOS kernal part 2. At $C100-$C2C5 there is a jump table 
for a number of important functions. 



6.7.2 Important memory locations 

$0030 Mouse flag 

Bit 7=0: no mouse action 

Bit 6=1: tests for marked area 



$0039 Joystick flag 

Bit 7=0: no jobs in job buffer 
Bit 6=1: stick position changed 
Bit 5=1: button pressed 

$003A Current mouse X-position low 

$003B Current mouse X-position high 

$003C Current mouse Y-position 

$84 Al Job address low: button pressed 

$84A2 Job address high: button pressed 

$84A5 Job address low: joystick movement 
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$84A6 Job address high: joystick movement 

$84A7 Job address low: mouse left specific area ($84B6 not equal to 0) 

$84A8 Job address high: mouse left specific area 

$84B6 Mouse status register 

Bit 7=1: Contact upper border (area 1) 

Bit 6=1: Contact lower borer 

Bit 5=1: Contact left border 

Bit 4=1: Contact right border 

Bit 3=1: Mouse outside second marked area 

$84B8 Upper border for mouse 

$84B9 Lower border for mouse 

$84BA Left border for mouse LOW 

$84BB Left border for mouse HIGH 

$84BC Right border for mouse LOW 

$84BD Right border for mouse HIGH 

$84C1 Upper border for mouse ' (2nd area) 

$84C2 Lower border for mouse (2nd area) 

$84C3 Left border for mouse LOW (2nd area) 

$84C4 Left border for mouse HIGH (2nd area) 

$84C5 Right border for mouse LOW (2nd area) 

$84C6 Right border for mouse HIGH (2nd area) 

$8501 Maximum mouse speed 

$8502 Minimum mouse speed 

$8503 Acceleration: increment 

$8505 Code for current button position 
Bit 7=0: button pressed 
Bit 7=1: not pressed 
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$8506 Code for current stick position 
$00 = right 
$02 = up 
$04 = left 
$06 = down 

$FF = error or neutral position 
$8507 Current mouse speed 
$8516 Current year 
$8517 Current month 
$8518 Current day 
$8519 Current hour 
$851A Current minute 
$851B Current second 
$87DD Number of jobs in buffer 1 

$8719-$872C Table of flags for the jobs in buffer 1 

$872D-$8755 Table of job addresses in buffer 1 (low/high) 

$877E Number of jobs in buffer 2 

$877F-$8792 Table of delay counters LOW for buffer 2 

$8793-$87A6 Table of counters HIGH for buffer 2 

$87A7-$87BA Job addresses LOW buffer 2 

$87BB-$87CE Job addresses HIGH buffer 2 

$87D7 FIFO read pointer 

$87D8 FIFO write pointer 

$87DA-$87E9 FIFO (buffer 0) 

$C2C8 job loop 

$CC4A - loads deskTop * 
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$E2DC - IRQ entry * 

$E36F read the keyboard 

$E5F0 mouse movement within the IRQ * 

$FE8B Absolute acceleration 

$FE8C X-speed (+/-) 

$FE8D Y-speed (+/-) 

$FE8E Value of the joystick port, button only 

$FE8F Value of the joystick port, stick only 

$FE90 Value of the joystick port 
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Glossary 



Accessory: A program that is available at practically any time. For example, 
you can create a graphic document with geoPaint, and then use the 
calculator while you're in the middle of editing it. You cannot use multiple 
accessories at the same time, however. 

Application: A program that can be loaded only from the deskTop. An 
application makes use of the GEOS routines (for example, geoPaint and 
geoWrite). 

Assembly language: A computer language that has a one-to-one relationship 
to machine language. Assembly language is simply a more readable way of 
writing machine language. 

Backup: Name for a copy of the contents of a diskette. There is also a 
program on the GEOS diskette with the same name. This program can be 
used to make copies. It can be loaded from GEOS (with a double click) or 
from BASIC with the following direct conmiands: 

LOAD "BACKUP", 8 
RUN 

BASIC: One of the most popular high-level language. The '64 understands 
BASIC only indirectiy. The only language that the computer understands 
directly is machine language, which is rather difficult for humans to work 
with. BASIC is translated into this machine language by the BASIC 
interpreter. BASIC is built into the *64, so it is available to you at any time. 

BASIC interpreter: A program that converts BASIC into machine language. 
If you write a BASIC program and start it with RUN, the program's BASIC 
conmiands are broken up into the smallest tasks that the computer can 
process — ^in machine language code. 

Booting: The name of the procedure by which GEOS and other programs 
are loaded and started. You can boot GEOS only from the original diskette. 

Border: Refers to a specific area on the screen when you are in the deskTop. 
This area lies below the GEOS window at about tiie level of the printer icon. 
When icons are placed on the border, their order can be changed, and they 
can be copied. 
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Buffer: An area of memory used for short-term data storage. We usually use 
this term to describe a diskette buffer. This diskette buffer stores the sectors 
that have been read in from diskette or will be written to the diskette. 

Copy protection: Diskettes can usually be copied just like cassettes can be 
copied. Since software manufacturers often see unrestricted copying of 
software as contrary to their business interests (as well as a violation of 
copyright laws), they attempt to prevent the successful copying of their 
disks. Usually some aspect of the diskette track or sector is changed, and 
this alteration is tested by tiie program. If the alteration is not on the inserted 
diskette, the program will not run. These alterations — ^the copy protection — 
cannot normally be copied. GEOS has a very effective form of copy 
protection, which is checked only when you're booting. 

Cursor: Flashing symbol on the screen that tells you the computer is waiting 
for input. Chi the '64 under GEOS, the cursor appears as a vertical line; the 
usual *64 cursor is rectangular. In geoWrite the cursor indicates the location 
at which the next letter will appear in the text 

<DEL> key: Located on the upper right of the keyboard, this key deletes 
one character to tiie left of the cursor when pressed. 

deskTop: A program that creates a user interface resembling the surface of a 
desk. On this "desk" objects can be moved and processed. In addition, the 
deskTop contains a printer and a waste basket. deskTop tries to make 
working with the user interface like working on an ordinary desk top. 

Destination disk: The diskette tSi which you want to copy a file. 

Directory: The table of contents of a diskette. A file entry is created in the 
directory when each file is saved so that the disk drive does not have to 
search through the entire diskette to find a file. 

Disk buffer: see Buffer. 

File: A collection of data. A file is any cohesive block of data. The 
difference between a file and a program is that a program also contains data 
items that are recognized by the computer as commands. Under GEOS, 
each file has a name (filename) and also an icon (symbol). Documents, 
programs, photo albums, etc. are all files. 
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File entry: Important data about a fUe is stored as a file entry in the disk 
directory. This data includes the filename, size, location on the diskette, 
type of file, and so on. 

Formatting: The process that prepares a diskette for use by the '64. The 
diskette is completely erased in this process. You should format all of the 
disks which you need for working with GEOS under GEOS — ^its formatting 
differs from the normal '64 format conmiand. GEOS gives die diskette a 
special format 

GEOS: Graphic Environment Operating System. GEOS creates a user 
interface with windows, pull-down menus, icons, and a joystick. In 
addition, it offers fast disk operations and its own file format. 

GEOS window: Designates a section of the screen (usually the middle) in 
which up to eight files can be displayed at one time in the deskTop. 

geoPaint window: The section of the screen in which you create and edit 
your graphic documents. The window displays only a small part of the 
entire document. You can move this part 

Hardcopy: A paper copy of the information on the '64 screen that is 
produced by a printer or plotter. 

Icon: A graphic symbol. GEOS represents its documents and graphics on 
the screen as icons when you work with deskTop. The appearance of an 
icon generally correlates with its purpose. The printer and waste basket are 
also icons. 

Interrupt: Process used by the computer to interrupt its current task, process 
another task, and then return to its original work. In GEOS, reading the 
joystick and keyboard is accomplished t&ough interrupts. 

Joystick and joystick pointer: An important part of the GEOS user 
interface, the joystick pointer represents your finger on the screen. With this 
"finger" you can grab icons (by clicking the fire button) and move thent 

The joystick pointer can assume a variety of shapes in GEOS. Normally it is 
displayed as an arrow. You may change the arrow to another shape by 
editing the pointer sprite in the Preference Manager. The joystick pointer 
might also look like a crosshair or a thin pen in geoPaint The joystick 
pointer is moved with the joystick. The fire button is used to click at the 
spot to which the arrow points. 
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Menu: Line on the screen (usually in the upper left) that lists various 
sub-menus. deskTop contains the following menus: gees, file, view, 
disk, and special* Each names a menu containing a set of additional 
commands known as items. When you click an item in the menu, its 
sub-menu is displayed in a window below the menu. 

Operating system: Describes a program that performs the most important 
and fundamental operations of a computer. Without an operating system 
program, tiie computer can do nothing. In the '64 the operating system is 
stored in ROM so that it remains intact when the power is turned off. 

Page pointer: Term from geoPaint and geoWrite. In geoPaint it refers to a 
rectangle in the status line. This rectangle corresponds to the entire page, 
and the small rectangle that appears in the upper left comer at the beginning 
indicates the situation of the geoPaint window. In geoWrite it appears at the 
top of the screen next to the name of the document and also indicates the 
page number. 

Pixel: Smallest representable point on the screen. 

Printer adaptation: Since there are different types of printers, not every 
printer can be connected to every computer. Usually a program known as a 
printer driver must be loaded to match the computer to the printer. You tell 
the computer what type of printer you are using before you print something. 

Proportional type: A kind of type in which the letters require a variable 
amount of space. For example, the letter *T" occupies considerably less 
space than the letter "M". 

<RESTORE>key: Located on the upper right of the keyboard in the second 
row, it's used in GEOS to reboot the system. If you exited GEOS through 
BASIC or by loading a BASIC program, insert the original diskette and 
press the <RESTORE> key to boot GEOS. 

Screen memory: Part of the computer's internal memory. It stores 
information that determines the appearance of the screen. Without GEOS, 
the screen memory usually consists of 1000 memory locations, containing 
the codes for 40 x 25 possible characters on the screen. It's sufficient to 
write the correct number in the screen memory to display a character on the 
screen. In contrast to this there is also the hi-res (high-resolution) screen. 
You're not limited to the Commodore-defined character sets with this 
screen. Instead, you can determine the display of the entire screen with 
individual pixels. GEOS uses this hi-res screen. 
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Scroll box: A small rectangle that contains two arrows. You can scroll the 
contents of the window in the direction of the arrows. This causes part of 
the screen display to disappear and additional lines to appear at tiie opposite 
side of the screen. The scroll box is usually used when the window is too 
snniall to contain all of the information. 

Sector: The diskette is divided into a number of tracks. In turn, the tracks 
are divided into a number of sectors. The disk drive can locate a sector on 
the diskette with the help of special markings. A sector contains a maximum 
of 256 bytes. When you store a program, it is divided up into suitable 
segments. These segments are then stored one to a sector. 

Single-step simulator: A program that causes another program to be 
processed step by step, allowing the user to examine important information 
after each step. A single-step simulator program is printed in Chapter 5 of 
this book. You can use it to examine GEOS programs step by step. 

Source disk: The original diskette. This is the diskette you want to copy. 

Sprite: Graphic symbols that can be moved on the screen. Sprites on the *64 
consist of 24x21 point blocks. Sprites are especially useful for writing 
games because they can be moved very easily. For example, GEOS uses 
sprites for displaying the joystick pointer on the screen. Because sprites are 
created differently than the normal screen elements, they do not appear on a 
hardcopy. 

Track: The diskette is divided into a number of circular tracks, which 
consist of a number of sectors. There are 35 tracks on a '64 diskette. 

User interface: Many computers allow you to communicate only in a 
programming language (such as BASIC). Before the computer can do any 
useful work for you, you must first learn the language. With a good user 
interface you can use a computer without any knowledge of progranmiing 
languages or how the computer actually works. One user interface involves 
graphically displaying important elements for working with the computer on 
the screen itself, which can then be manipulated to perform various tasks. 
For example, files are displayed as graphic symbols called icons in GEOS. 
You delete a file simply by moving the file's icon over to the waste basket 
icon. 
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Window: A section of the screen delimited by a border. This section is then 
treated as a separate screen for a certain length of time, GEOS uses 
windows to output information (error messages) or to ask you for 
information (the name of a document). The special thing about windows is 
that data can be displayed on the screen and 2rfterward the original screen is 
restored. To do this, the part of the screen memory that will be changed by 
the window is saved at another location and later written back. 

Working copy: You must copy the contents of the GEOS distribution 
diskette to another diskette and delete some of the application/accesoiy 
programs in order to make some room on the diskette for real work. This 
"incomplete" copy is called a working copy. 
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A 

accessory programs 17, 67-86 

add drive 38 

adding files 19 

airbrush 52, 133-135 

alarm clock 35, 70, 180-186 

application programs 7, 24, 43, 

68, 80, 87, 88, 111, 120, 130, 

134, 203, 221, 267, 269 

arrows 37, 50, 59, 67 

ASCII 147-148, 161-165, 231, 

254 

B 

backup copy diskettes 7-14, 128, 
197-198 

BACKUP 8, 12 

BAM 258-259, 275 
BASIC 39 

BASIC 33, 147-175, 267-269, 
281-285 

blank diskettes 8, 19, 38, 127, 197 
booting 7, 14, 125-129, 197-198, 
254, 262, 271, 281, 282, 284 
boundary 93, 131 

BREAK IRQ 245 

bricks (geoPaint pattern) 136 
brushes 48, 49, 53, 133 
BSW (font) 90-93, 104, 112, 114, 
118, 137, 140 

buffer 160-164, 167-170, 177, 
230, 231, 238, 248, 250, 265, 
266, 269, 275, 277, 282 

c 

C-64 31, 71, 87, 108, 235, 244, 

256, 267, 269, 271, 274 

C= (Commodore key) 33, 214- 

217, 281-285 

calculator 35, 71 

calendar (Notepad) 144-147, 180 



CANCEL button 130, 219, 224, 
225, 232-239 
change brush 48 
characters 27, 43, 65, 76, 91, 111 
charts 87-99 

circles (geoPaint) 106, 120-121, 
132 

clear 51 

clicking 12, 24, 27 

clock (programming) 178 

clock (constant display prg.) 

187-196 

close 22 

close icon 7, 9, 12, 15, 22, 32 
color 56 
color off 49 
command menu 8 
<CONTROL> key 141 
copy 47, 61 
copying (files) 42 
Create 25, 43 

crosshairs 47, 51-55, 95-97, 103 
cursor 18, 26, 55 
custom windows 225 
cut 47, 61 

D 

data files 33 
DATASETrE31 

<DEL> key 13, 38, 46, 61, 63-65, 

67, 72, 142, 143 

deleting 14, 40, 142, 162}} 

deskTop 11, 16, 18, 20, 28, 

31-40, 128-130, 263-265, 270-272 

deskTop info 34 

deskTop parameters 17, 34, 74-75, 

125, 215, 276, 277 

destination diskette 8, 38, 42, 47 

diagrams 87-99 

dialogue box 13, 219, 223-224 
dialogue boxes (custom) 225-233 
directory 3, 13, 20-23 
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disk 12, 22, 37 

disk drive 7-10, 13-15, 38, 126- 

128, 160, 178, 197, 234 

disk drive head alignment 126-127, 

198 

disk drive error messages 218, 235 
diskette icon 32 

documents (GEOS) 17, 34, 43, 
44, 46-49 

dogear page 21, 145 

DOS (Disk Operating System) 129, 

173, 252-258, 269 

dotted lines 134-137 

double-clicking 24, 42, 54, 132 

duplicate 35 

Dwinelle (font) 137, 140 

E 

edit 47 

editing 47-48, 50, 51, 54, 55, 
57-66 

edit box (geoPaint) 47, 48-55 

electronic circuits 108 

ellipses (geoPaint) 106, 120, 132 

Epson FX-185 132 

Epson FX-85 130, 131 

eraser (geoPaint) 48, 54, 57, 75, 

102, 132 

error box 218, 223 
F 

faucet (geoPaint) 51, 90, 97, 133, 
265 

FIFO storage 248, 277 
Figures (listed) viii-ix 
file 35 

files (GEOS) 8, 14, 16-21, 23, 

files (non-GEOS) 33 

files (under DOS) 252 

file structure 146, 252-259, 263- 

264, 269 

file 'types 33, 148, 163, 173, 177, 



252-256, 262 

FILEMASTER3, 129, 148-150, 

160, 167, 171-177, 189, 203, 242, 
268-273 

FILEMASTER menu 171 
FILEMASTER (prg. listing) 149 
filenames 17, 35, 44, 131, 162, 
163, 167, 172, 194, 230, 269 
fire button 12 
font 26 

font (geoPaint) 49 

fonts 21, 26-28, 33, 49, 54, 55, 

65, 67, 84, 90, 121, 137-143, 262 

format 39 

formatting GEOS diskettes 8, 39 
formats (geoWrite) 65-66, 128, 
137-143 

G 

geoPaint 3, 17, 24, 36, 42, 44-56, 

53-56, 58, 61-64, 131-136 

geoPaint info 45 

gees 17, 45 

gees info 34 

GEOS Hi, 3, 4, 7-25 

GEOS BOOT 9, 14, 16, 87, 100, 

108, 173, 253, 262 

GEOS file structure 252, 256, 

258, 259 

GEOS KERNAL 14-15 

GEOS User's Guide 7 

GEOS VI. 3, 258 

GEOS V1.2 3, 24, 58 

geoWrite 17, 20-21, 23-26, 28, 

32, 33, 35, 57-66, 72-81, 87, 

137-143, 177 

ghost icon 15, 20, 23 

go to page 64 

graphics 36, 56, 62, 64, 68, 76- 

81, 87, 88, 120, 130, 214, 231 

graphs 87-99, 134 
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H 

hardcopy 4, 41, 45, 49, 66, 115, 
133, 143, 248 
hide pictures 64 
highlighting text 141 

I 

IC (integrated circuit) 109-110 
icons 4, 7-9, 12-17, 20-24, 32, 
36, 40-43, 45, 49, 50-55, 58, 
68-70, 72, 73, 79, 80, 82, 89, 90, 
icons (custom) 148-178, 189, 
indirect addressing 229, 237 
info 35 

info box 14, 15, 32, 35, 37, 41, 
129, 148, 149, 163, 166-170, 
173-175, 177, 189, 204, 256, 265 
INFO sector 254-256, 265, 269, 
271 

invert 51 

IRQ (Interrupt Request) 184-186, 
214, 244, 245, 277, 278 
items (menii) 8, 32 

J 

job code 226, 228-230, 232, 233, 
236, 239 

job loop 216, 247-251 272, 277 
job structure 247-251 
job table 250 

joystick pointer 24, 65, 88, 90 
jump commands 235 

K 

KERNAL 178-180, 197-199 
keyboard 40 

L 

Letters 19, 20, 22-24, 28 
loading GEOS 9, 11, 18, 24, 35, 
58, 60, 64, 72, 125, 126, 128, 



214, 256, 258, 264, 266, 267, 272 
loading prg's in machine language 
129, 197, 198, 203, 253-256 
load problems (GEOS) 125 

M 

margins (geoWrite) 59, 66, 67, 
138-142 

memory locations (GEOS) 274-278 
menu 8, 12-14, 17, 19, 24, 26-28 
mirror x 51 
mirror y 51 
modem 39 

monitor (machine language) 
146-148, 203-204, 214, 234, 241, 
256, 261, 263, 265, 266, 268, 
271, 273 

monitor (screen) 8 
move 51 

N 

normal edit 48 

notepad 34 

Notepad 71-73, 144-147 

O 

open 8, 12, 13, 17, 22-24, 35, 43 
operating system 125, 197, 203, 
214, 217, 218, 221, 226, 234, 
244, 267 

options 19, 24, 47, 49, 53, 58, 
64, 97, 128, 129, 133, 171 

P 

page break 64 
page map 44 
paste 47 

patterns (graphic) 57, 89, 90-91, 

97, 133-136, 224, 240 

PC board 108-110 

pencil (geoPaint) 44, 48, 53-54, 
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75, 89, 101, 121, 132 

photo manager 34 

Photo Manager 76-79 

photo scrap 47 

pixel edit 48, 50, 54, 75, 89, 

102, 105, 109, 110, 112-118, 133 

pixels 46, 48, 52, 54 

point sizes (font) 26 

pointer 4, 8, 12, 14, 15, 17, 18, 

20,74-77, 277 

pointer (editing) 75 

pointer speed 17 

POKES 129, 197 

position line (geoWrite) 59 

Preference Manager 17-18, 34, 68, 

73-75, 88 

preference mgr 34 
preferences 77, 234 
preview mode 46, 60, 97, 98, 
107, 119, 142 

print 36, 46, 61, 121, 130-132, 
137, 141, 147, 171, 177, 263 
printer 7, 32, 34-36, 41, 45, 46, 
49, 60, 61, 87, 100, 108, 126, 
130-132, 147 

printer (initializing) 130, 160, 214 
printing 41, 45, 60, 129-130 
program file 33 
programming the clock 178 

Q 

Q-LINK (QuantumLink) 39 
quit 43, 60, 128 

R 

recover 46 

rectangles (geoPaint) 55, 120, 
121, 132 

reformatting (geoWrite) 140 
registers 130, 178, 179, 203, 215, 
238, 245, 246 

rename 13, 35, 38, 46, 61, 218 



reset 39 
RESET 197, 271 
restarting GEOS 126-128, 165 
<RESTORE> 8-10, 39, 284 
<RETURN> key 7-9, 11, 14 
Roma (font) 26, 28, 55 
rotating (geoPaint) 118, 147 
ruler (geoPaint measurements) 52 

S 

scaling (jgeoPaint) 131 
schematic diagrams (geoPaint) 111 

SCRATCH 129 
screen 4, 7-9, 11-13, 15-17 
scroll box 37, 43, 47, 48, 50, 59, 
67, 84,94, 106, 115-117, 128 
security 147 

SEQUENT I AL(file type) 173, 253, 

254, 256, 263, 269 

select printer 34 

select input 34 

single-step simulator (SST) 

203-217 

source disk 9 

special 39 

sprites 4, 45, 160, 177 

starting geoPaint 42 

starting GEOS 7-23 

starting geoWrite 57 

status box 8, 44, 50-54, 56, 

90-97, 103, 127, 184, 185, 215, 

217,245,248-249,276 

status lamp (disk drive) 8 

strings 221, 228, 229, 231, 256 

sub-menu 8, 12, 13, 19 

SWAP file 18, 68, 128, 214, 256, 

258, 270-272 

system file 33 

system IRQ 184-186, 214, 244, 
245, 277, 278 
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T 

tabs 14, 15, 59, 66, 67, 141, 143 
text cursor 18, 26, 55, 59, 61-67 
text (geoPaint) 54 
text manager 35 
Text Manager 23,80-86 
text scrap 62 
TIME SET 18, 76 
To Deb25, 79, 80 
toolkit (geoPaint) 44, 49-56 
track (diskette) 146, 161-163, 167, 
173, 199, 252-255, 258, 260, 
263-266, 269 

track/sector (GEOS diskette format) 
146, 263 

troubleshooting 126 



Work 1 20, 22, 23, 28 
work diskette 7, 9-16, 18, 19, 22 
write protect tab 14 
write protect box 15 
WYSIWYG display 137-141 

50-60 Hz current 125, 178-179, 

197-199 

64C Hi 



U 

underline 92, 137 
undo 57 

University (font) 55, 102, 110 
update 46, 60, 61, 248 



V 

validate 38, 129 
VALIDATE POS command) 38, 
129 

video chip 214, 244 
view 36 

VLIR (file type) 146, 173, 253, 
256, 263, 264 

Vl.O and V1.2 (GEOS versions) 3, 
258-261 



W 

waste basket Hi, 7, 32 
wedging into GEOS 268 
windows 8, 10, 13-15, 17-23 
window techniques 218-243 
windows (custom) 218-243 
word wrap 65 
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For your convenience, the program listings contained in this book are 
available on an 1541/1571 formatted floppy disk. You should order the 
diskette if you want to use the book's programs, but don't want to type 
them in from the listings in the book. 

All programs on the diskette have been fully tested. You can change the 
programs for your particular needs. The diskette is available for $14.95 plus 
$2.00 ($5.00 foreign) for postage and handling. 

When ordering, please give your name and shipping address. Enclose a 
check, money order or credit card information. Mail your order to: 

Abacus Software 
P.O. Box 7219 
Grand Rapids, MI 49510 



Or for fast service, call (616) 241-5510. 
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COMMODORE 

THE AUTHORITATIVE 1 I 
MSIIHfTS GUIDE U 



INTERNALS 
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A DATA • BEC KERaCPK PUBLISHED BY 

AbacusQQSSoflware 





Detailod guide presents the 128's 
operating system, explains graphic 
chips, Memory Management Unit. 80 
column graphics and commented 
ROM listings. 500pp $19.95 



Get all the Inside Information on 
BASIC 7.0. This exhaustive hand- 
t>ook is complete with commented 
BASIC 7.0 ROM listings. Coming 
Summer'86. $19.95 



Filled with info for everyone. Covers 
80 column hi-res graphics, win- 
dowing, memory layout, Kernal 
routines, sprites, software pro- 
tection, autostarting. 300pp $19.95 



Insiders' guide tor novice & ad- 
vanced users. Covers sequential & 
relative tiles, & direct access com- 
mands. Describes DOS routines. 
Commented listings. $19.95 



Learn fundamentals of CAD while 
developing your own system. Design 
objects on your screen to dunp to a 
printer. Includes listings for '64 with 
Simon's Basic. 300|V $19.95 




Introduction to programing: problem 
analysis; thorough description of all 
BASIC commands with hundreds of 
examples; monitor commands; util- 
ities; much more. $16.95 



Presents, dozens of programming 
quick-hitters. Easy and useful 
techniques on the operating system, 
stacks, zero-page, pointers, the 
BASIC interpreter and mofo. $1 6.95 




Abacus 



Essential guide for everyone inter- 
ested in CP/M on the 128. Simple 
explanation of the operating system, 
memory usage, CP/M utility pro- 
grams, submit tiles & more. $1 9.95 



ANATOMY OF C-64 Insider's guide to the 
'64 internals. Graphics, sound, I/O, kernal, 
memory maps. more. Complete commented 
ROM listings. 300pp $19.95 



ANATOMY OF 

handbook on 
examples and 
1541 ROM listi 



DRIVE Best 
all. Many 
commented 
s'OOpp $19.95 



MACHINE LANGUAGE C-64 Learn 
6510 code write fast programs. Many sam- 
ples and listings for complete assembler, 
monitor, & simulator. 200pp $14.95 

GRAPHICS BOOK C-64 - best reference 
covers basic and advanced graphics. 
Sprites, animation. Hires. Multicolor, 
lightpen. 3D-graphics, IRQ, CAD, pro- 
jecttons, curves, more. 390pp $19.95 



TRICKS & TIPS FOR C-64 Collection of 
easy-to-use techniques: advanced graphics, 
improved data input, enhanced BASIC, 
CP/M, more. 275pp $19.95 

1941 REPAIR & MAINTENANCE 
Handbook describes the disk drive hard- 
ware. Includes schematics and techniques 
to keep 1541 running. 200pp $19.95 

ADVANCED MACHINE LANGUAGE 

Not covered elsewhere: - video controller, 
interrupts, timers, clocks. I/O. real time, 
extended BASIC, more. 210pp $14.95 

PRINTER BOOK C-64/V(C-20 Under- 
stand Commodore, Epson-compatble print- 
ers and 1520 plotter. Packed: utilities; gra- 
phics dump; 3D-plot; commented MPS601 
ROM listings, more. 330 pp $19.95 



SCIENCE/ENGINEERING ON C-64 In 

depth intro to computers in science. Topics: 
chemistry, physics, biology, astronomy, 
eledronks, others. 350pp $19.95 

CASSETTE BOOK C-64/VIC-20 
Comprehensive guide; many sample 
programs. High speed operating system 
fast file toading and saving. 225 pp $14.95 
IDEAS FOR USE ON C-64 Themes: 
auto expenses, calculator, redpe file, stock 
lists, diet planner, window advertising, 
others. Includes listings. 200pp $12.95 
COMPILER BOOK C-64/C-128 All you 
need to know about compilers: how they 
work; designing and writing your own; 
generating machine code. With working 
example compiler. 300pp $19.95 



Adventure Gamewrlter't Handbook 

Step-by-step guide to designing and writing 
your own adventure games. With automated 
adventure game generator. 200pp $14.65 

PEEKS & POKES FOR THE 0-64 

Includes in-depth explanations of PEEK, 
POKE, USR. and other BASIC commands. 
Learn the "inside" tricks to get the most out 
of your '64. 200pp $14.95 

Optional Diskettes for books 
For your convenience, the programs 
contained in each of our books are avail- 
able on diskette to save you time entering 
them from your keyboard. Specify name of 
book when ordering. $i 4.95 each 



Abacus 



C-128 and C-64 aro trademarks of Commodore Business Machines Inc. 



Software 



P.O. Box 7219 Dept,M9 Grand Rapids, Ml 49510 ■ Telex 709-101 - Phone (616) 241-5510 

Optional diskettes available for all book titles - $14.95 each. Other books & software also available. Call for the name of your 
nearest dealer. Or order directly from ABACUS using your MC, Visa or Amex card. Add $4.00 per order for shipping. Foreign 
orders add ^10.00 per book. Call now or write for your free catatog. Dealer inquires welcome-over 1400 dealers nationwWe. 



BASIC 
Compiler 




Give your BASIC programs the speed 
and performance they deserve 



The complete compiler 
and development pack- 
age. Speed up your pro- 
grams 5x to 35x. Many 
options: flexible memory 
management; choice of 
compiling to machine 
code, compact p-code or 
both. '1 28 version: 40 or 
80 column monitor output 
and FAST-mode opera- 
tion. '128 Compiler's ex- 
tensive 80- page pro- 
grammer's guide covers 
compiler directives and 
options, two levels of 



optimization, memory usage, I/O handling. 80 column hi-res graphics, faster, 
higher precision math functions, speed and space saving tips, more. A great 
package that no software library should be without. 128 Compiler $59.95 

64 Compiler $39.95 

For school or software 
development. Learn C on 
your Commodore with our in- 
depth tutorial. Compile C pro- 
grams Into fast machine 
language. C-128 version has 
added features: Unix™ -like 
operating system; 60K RAM 
disk for fast editing and 
compiling Linker combines 
up to 10 modules; Combine 
M/L and C using CALL; 51 K 
available for object code; 




2£f Compiler 

On your 

The language of the 80's and beyond 



Fast loading (8 sec. 1571, 18 sec. 1541); Two standard I/O librarys plus 
two additional libraries— math functions (sin, cos, sqrt, etc.) & 20+ graphic 
commands (line , fill , dot , etc.) . C-1 28 $ 5 9 . 9 5 

C-64 $59.95 

Easily create professional 
high quality charts and 
graphs without programming. 
You can immediately change 
the scaling, labeling, axis, 
bar filling, etc. to suit your 
needs. Accepts data from 
CalcResult and MultiPlan. 
C-128 version has 3X the 
resolution of the '64 version. 
Outputs to most printers. 

C-128 $39.95 
C-64 $39.95 




PowerPlan 

One of the most powerful spreadsheets with integrated 
graphics. Includes menu or keyword selections, online help 
screens, field protection, windowing, trig functions and more. 
PowerGraph, the graphics package, is Included to create 
Integrated graphs and charts. C-64 $39.95 



Technical Analysis System for the C-64 
Ada Compiler for the C-64 
VIdeoBasIc Language for the C-64 



$59.95 
$39.95 
$39.95 



Remarkably easy-to-use 
interactive drawing pack- 
age for accurate graphic 
designs. New dimension- 
ing features to create 
exact scaled output to all 
major dot-matrix printers. 
Enhanced version allows 
you to input via keyboard 
or high quality lightpen. 
Two graphic screens for 
COPYing from one to the 
other. DRAW, LINE. BOX. 
CIRCLE, ARC, ELLIPSE 
available. FILL objects 
with preselected PAT- 
TERNS; add TEXT; SAVE and RECALL designs to/from disk. Define your own 
library of symbols/objects with the easy-to-use OBJECT MANAGEMENT 
SYSTEM-store up to 104 separate objects. C-1 28 $59.95 

C-64 $39.95 

Not just a compiler, but a 
complete system for develop- 
ing applications in Pascal 
with graphics and sound 
features. Extensive editor 
with search, replace, auto, 
renumber, etc. Standard J & 
W compiler that generates 
fast machine code. If you 
want to learn Pascal op \o 
develop software using the 
best tools available-SUPER 
Pascal is your first choice. 

C-64 $59.95 



OTHER TITLES AVAILABLE: 

COBOL Compiler 

Now you can learn COBOL, th^gtost widely used commercial 
programing language, and^mPWOQ^ on your 64. COBOL 
Is easy to learn because ll^ag|)^read. COBOL Compiler 
package comes completdg^ftPT Editor, Compiler, Interpreter 
and Symbolic Debugger. C-64 $39.95 

Personal Portfolio Manager 

Complete portfolio management system for the individual or 
professional investor. Easily manage your portfolios, obtain 
up-to-the-minute quotes and news, and perform selected 
analysis. Enter quotes manually or automatically through 
Warner Computer Systems. C-64 $39.95 

Xper 

XPER is the first "expert systerrf' for the C-1 28 and C-64. While 
ordinary data base systems are good for reproducing facts, 
XPER can derive knowledge from a mountain of facts and help 
you make expert decisions. Large capacity. Complete with 
editing and reporting. C-64 $59.95 

c-1 28 and C-64 ere trsdemivks of Commodae Business k/lachines Inc. 

Unix is a tademark of Befl Leborolories 
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P.O. Box 7219 Dept.M9 Grand Rapids, Ml 49510 - Telex 709-101 - Phone (616) 241-5510 

Call now for the name of your nearest dealer. Or to order directly by credit card, MC, AMEX of VISA call (616) 
241-5510. Other software and books are available-Call and ask for your free catalog. Add $4.00 for shipping 
per order. Foreign orders add $12.00 per item. Dealer inquires welcome-1400+ nationwide. 
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GEOS 




IN3II> 
AND OUT 




Singld-step through GEOS's internat workings 



Use FileMastdr to convert your programs to 
GEOS format (Irkcludes icon edKor) 



Create a dock that you can display 
oorTGtantty in the comer 



Whether you're a beginner or a seasoned computer user, if you use GEOS, I 

then GEOS Inside and Out contains information you need. This bool< I 

begins with a complete, thorough introduction to GEOS. You'll also learn how I 

to add your own applications to GEOS. It contains the listing for FileMaster, so I 

you can convert your programs to GEOS formal and create an icon for them. I 

Geos Inside and Out will help you: I 

• Master GEOS by following the detailed introduction I 

• Use your own programs in GEOS (includes icon editor) 

• Display memory and the registers with the single-step simulator 

• Add windows to your own programs 

• Learn about the GEOS f iie format 

• Study memory layout and important memory locations 

About the authors: 

Manfred Tornsdorf is a physics major who became interested in computers 
through his hobby— electronics. He is the author of a popular European book 
Textomat Plus Tricks and Tips. Ruediger Kerkloh has owned a Commodore 64 
for many years. His specialties are peripheral devices and assembly language 
programming for peripherals. 
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GEOS is a tmdomafk of Berketey Softworks 
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